Expand description
Amazon S3 Glacier (Glacier) is a storage solution for "cold data."
Glacier is an extremely low-cost storage service that provides secure, durable, and easy-to-use storage for data backup and archival. With Glacier, customers can store their data cost effectively for months, years, or decades. Glacier also enables customers to offload the administrative burdens of operating and scaling storage to AWS, so they don't have to worry about capacity planning, hardware provisioning, data replication, hardware failure and recovery, or time-consuming hardware migrations.
Glacier is a great storage choice when low storage cost is paramount and your data is rarely retrieved. If your application requires fast or frequent access to your data, consider using Amazon S3. For more information, see Amazon Simple Storage Service (Amazon S3).
You can store any kind of data in any format. There is no maximum limit on the total amount of data you can store in Glacier.
If you are a first-time user of Glacier, we recommend that you begin by reading the following sections in the Amazon S3 Glacier Developer Guide:
-
What is Amazon S3 Glacier - This section of the Developer Guide describes the underlying data model, the operations it supports, and the AWS SDKs that you can use to interact with the service.
-
Getting Started with Amazon S3 Glacier - The Getting Started section walks you through the process of creating a vault, uploading archives, creating jobs to download archives, retrieving the job output, and deleting archives.
If you’re using the service, you’re probably looking for GlacierClient and Glacier.
Structs§
- Abort
Multipart Upload Input Provides options to abort a multipart upload identified by the upload ID.
For information about the underlying REST API, see Abort Multipart Upload. For conceptual information, see Working with Archives in Amazon S3 Glacier.
- Abort
Vault Lock Input The input values for
AbortVaultLock
.- AddTags
ToVault Input The input values for
AddTagsToVault
.- Archive
Creation Output Contains the Amazon S3 Glacier response to your request.
For information about the underlying REST API, see Upload Archive. For conceptual information, see Working with Archives in Amazon S3 Glacier.
- CSVInput
Contains information about the comma-separated value (CSV) file to select from.
- CSVOutput
Contains information about the comma-separated value (CSV) file that the job results are stored in.
- Complete
Multipart Upload Input Provides options to complete a multipart upload operation. This informs Amazon Glacier that all the archive parts have been uploaded and Amazon S3 Glacier (Glacier) can now assemble the archive from the uploaded parts. After assembling and saving the archive to the vault, Glacier returns the URI path of the newly created archive resource.
- Complete
Vault Lock Input The input values for
CompleteVaultLock
.- Create
Vault Input Provides options to create a vault.
- Create
Vault Output Contains the Amazon S3 Glacier response to your request.
- Data
Retrieval Policy Data retrieval policy.
- Data
Retrieval Rule Data retrieval policy rule.
- Delete
Archive Input Provides options for deleting an archive from an Amazon S3 Glacier vault.
- Delete
Vault Access Policy Input DeleteVaultAccessPolicy input.
- Delete
Vault Input Provides options for deleting a vault from Amazon S3 Glacier.
- Delete
Vault Notifications Input Provides options for deleting a vault notification configuration from an Amazon Glacier vault.
- Describe
JobInput Provides options for retrieving a job description.
- Describe
Vault Input Provides options for retrieving metadata for a specific vault in Amazon Glacier.
- Describe
Vault Output Contains the Amazon S3 Glacier response to your request.
- Encryption
Contains information about the encryption used to store the job results in Amazon S3.
- GetData
Retrieval Policy Input Input for GetDataRetrievalPolicy.
- GetData
Retrieval Policy Output Contains the Amazon S3 Glacier response to the
GetDataRetrievalPolicy
request.- GetJob
Output Input Provides options for downloading output of an Amazon S3 Glacier job.
- GetJob
Output Output Contains the Amazon S3 Glacier response to your request.
- GetVault
Access Policy Input Input for GetVaultAccessPolicy.
- GetVault
Access Policy Output Output for GetVaultAccessPolicy.
- GetVault
Lock Input The input values for
GetVaultLock
.- GetVault
Lock Output Contains the Amazon S3 Glacier response to your request.
- GetVault
Notifications Input Provides options for retrieving the notification configuration set on an Amazon Glacier vault.
- GetVault
Notifications Output Contains the Amazon S3 Glacier response to your request.
- Glacier
Client - A client for the Amazon Glacier API.
- Glacier
JobDescription Contains the description of an Amazon S3 Glacier job.
- Grant
Contains information about a grant.
- Grantee
Contains information about the grantee.
- Initiate
JobInput Provides options for initiating an Amazon S3 Glacier job.
- Initiate
JobOutput Contains the Amazon S3 Glacier response to your request.
- Initiate
Multipart Upload Input Provides options for initiating a multipart upload to an Amazon S3 Glacier vault.
- Initiate
Multipart Upload Output The Amazon S3 Glacier response to your request.
- Initiate
Vault Lock Input The input values for
InitiateVaultLock
.- Initiate
Vault Lock Output Contains the Amazon S3 Glacier response to your request.
- Input
Serialization Describes how the archive is serialized.
- Inventory
Retrieval JobDescription Describes the options for a range inventory retrieval job.
- Inventory
Retrieval JobInput Provides options for specifying a range inventory retrieval job.
- JobParameters
Provides options for defining a job.
- List
Jobs Input Provides options for retrieving a job list for an Amazon S3 Glacier vault.
- List
Jobs Output Contains the Amazon S3 Glacier response to your request.
- List
Multipart Uploads Input Provides options for retrieving list of in-progress multipart uploads for an Amazon Glacier vault.
- List
Multipart Uploads Output Contains the Amazon S3 Glacier response to your request.
- List
Parts Input Provides options for retrieving a list of parts of an archive that have been uploaded in a specific multipart upload.
- List
Parts Output Contains the Amazon S3 Glacier response to your request.
- List
Provisioned Capacity Input - List
Provisioned Capacity Output - List
Tags ForVault Input The input value for
ListTagsForVaultInput
.- List
Tags ForVault Output Contains the Amazon S3 Glacier response to your request.
- List
Vaults Input Provides options to retrieve the vault list owned by the calling user's account. The list provides metadata information for each vault.
- List
Vaults Output Contains the Amazon S3 Glacier response to your request.
- Output
Location Contains information about the location where the select job results are stored.
- Output
Serialization Describes how the select output is serialized.
- Part
List Element A list of the part sizes of the multipart upload.
- Provisioned
Capacity Description The definition for a provisioned capacity unit.
- Purchase
Provisioned Capacity Input - Purchase
Provisioned Capacity Output - Remove
Tags From Vault Input The input value for
RemoveTagsFromVaultInput
.- S3Location
Contains information about the location in Amazon S3 where the select job results are stored.
- Select
Parameters Contains information about the parameters used for a select.
- SetData
Retrieval Policy Input SetDataRetrievalPolicy input.
- SetVault
Access Policy Input SetVaultAccessPolicy input.
- SetVault
Notifications Input Provides options to configure notifications that will be sent when specific events happen to a vault.
- Upload
Archive Input Provides options to add an archive to a vault.
- Upload
List Element A list of in-progress multipart uploads for a vault.
- Upload
Multipart Part Input Provides options to upload a part of an archive in a multipart upload operation.
- Upload
Multipart Part Output Contains the Amazon S3 Glacier response to your request.
- Vault
Access Policy Contains the vault access policy.
- Vault
Lock Policy Contains the vault lock policy.
- Vault
Notification Config Represents a vault's notification configuration.
Enums§
- Abort
Multipart Upload Error - Errors returned by AbortMultipartUpload
- Abort
Vault Lock Error - Errors returned by AbortVaultLock
- AddTags
ToVault Error - Errors returned by AddTagsToVault
- Complete
Multipart Upload Error - Errors returned by CompleteMultipartUpload
- Complete
Vault Lock Error - Errors returned by CompleteVaultLock
- Create
Vault Error - Errors returned by CreateVault
- Delete
Archive Error - Errors returned by DeleteArchive
- Delete
Vault Access Policy Error - Errors returned by DeleteVaultAccessPolicy
- Delete
Vault Error - Errors returned by DeleteVault
- Delete
Vault Notifications Error - Errors returned by DeleteVaultNotifications
- Describe
JobError - Errors returned by DescribeJob
- Describe
Vault Error - Errors returned by DescribeVault
- GetData
Retrieval Policy Error - Errors returned by GetDataRetrievalPolicy
- GetJob
Output Error - Errors returned by GetJobOutput
- GetVault
Access Policy Error - Errors returned by GetVaultAccessPolicy
- GetVault
Lock Error - Errors returned by GetVaultLock
- GetVault
Notifications Error - Errors returned by GetVaultNotifications
- Initiate
JobError - Errors returned by InitiateJob
- Initiate
Multipart Upload Error - Errors returned by InitiateMultipartUpload
- Initiate
Vault Lock Error - Errors returned by InitiateVaultLock
- List
Jobs Error - Errors returned by ListJobs
- List
Multipart Uploads Error - Errors returned by ListMultipartUploads
- List
Parts Error - Errors returned by ListParts
- List
Provisioned Capacity Error - Errors returned by ListProvisionedCapacity
- List
Tags ForVault Error - Errors returned by ListTagsForVault
- List
Vaults Error - Errors returned by ListVaults
- Purchase
Provisioned Capacity Error - Errors returned by PurchaseProvisionedCapacity
- Remove
Tags From Vault Error - Errors returned by RemoveTagsFromVault
- SetData
Retrieval Policy Error - Errors returned by SetDataRetrievalPolicy
- SetVault
Access Policy Error - Errors returned by SetVaultAccessPolicy
- SetVault
Notifications Error - Errors returned by SetVaultNotifications
- Upload
Archive Error - Errors returned by UploadArchive
- Upload
Multipart Part Error - Errors returned by UploadMultipartPart
Traits§
- Glacier
- Trait representing the capabilities of the Amazon Glacier API. Amazon Glacier clients implement this trait.