This page is only for existing customers of the Amazon Glacier service using Vaults and the original REST API from 2012.
If you're looking for archival storage solutions, we recommend using the Amazon Glacier storage classes in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, and S3 Glacier Deep Archive. To learn more about these storage options, see Amazon Glacier storage classes
Amazon Glacier (original standalone vault-based service) will no longer accept new customers starting December 15, 2025, with no impact to existing customers. Amazon Glacier is a standalone service with its own APIs that stores data in vaults and is distinct from Amazon S3 and the Amazon S3 Glacier storage classes. Your existing data will remain secure and accessible in Amazon Glacier indefinitely. No migration is required. For low-cost, long-term archival storage, Amazon recommends the Amazon S3 Glacier storage classes
jobParameters
Provides options for defining a job.
Contents
- ArchiveId
-
The ID of the archive that you want. This field is required if the
Typefield is set toselectorarchive-retrieval. An error occurs if you specify this field for an inventory retrieval job request.Valid Values: Must be a valid archive ID that you obtained from a previous request to Amazon Glacier (Amazon Glacier).
Type: String
Required: Yes when
Typeis set toselectorarchive-retrieval. - Description
-
The optional description for the job.
Valid Values: The description must be less than or equal to 1,024 bytes. The allowable characters are 7-bit ASCII without control codes—specifically, ASCII values 32–126 decimal or 0x20–0x7E hexadecimal.
Type: String
Required: no
- Format
-
(Optional) The output format, when initiating a job to retrieve a vault inventory. If you are initiating an inventory job and don't specify a
Formatfield, JSON is the default format.Valid Values:
CSV|JSONType: String
Required: no
- InventoryRetrievalParameters
-
Input parameters used for a range inventory retrieval.
Type: InventoryRetrievalJobInput object
Required: no
- OutputLocation
-
An object that contains information about the location where the select job results are stored.
Type: OutputLocation object
Required: Yes, for
selectjobs. - RetrievalByteRange
-
The byte range to retrieve for an
archive-retrieval, in the form "StartByteValue-EndByteValue". If this field isn't specified, the whole archive is retrieved. If this field is specified, the byte range must be megabyte (1024*1024) aligned. Megabyte-aligned means that StartByteValue must be divisible by 1 MB, and EndByteValue plus 1 must be divisible by 1 MB or be the end of the archive specified as the archive byte size value minus 1. If RetrievalByteRange is not megabyte-aligned, this operation returns a400response.An error occurs if you specify this field for an
inventory-retrievalorselectjob request.Type: String
Required: no
- SelectParameters
-
An object that contains information about the parameters used for a select.
Type: SelectParameters object
Required: no
- SNSTopic
-
The Amazon Resource Name (ARN) of the Amazon SNS topic where Amazon Glacier sends a notification when the job is completed and output is ready for you to download. The specified topic publishes the notification to its subscribers.
The SNS topic must exist. If it doesn't, Amazon Glacier doesn't create it for you. Additionally, the SNS topic must have a policy that allows the account that created the job to publish messages to the topic. For information about SNS topic names, see CreateTopic in the Amazon Simple Notification Service API Reference.
Type: String
Required: no
- Tier
-
The tier to use for a select or an archive retrieval job.
Standardis the default value used.Valid Values:
Expedited|Standard|BulkType: String
Required: no
- Type
-
The job type. You can initiate a job to perform a select query on an archive, retrieve an archive, or get an inventory of a vault.
Valid Values:
select|archive-retrieval|inventory-retrievalType: String
Required: yes