Amazon Glacier
Developer Guide (API Version 2012-06-01)


Provides options for defining a job.



The ID of the archive that you want. This field is required if the Type field is set to select or archive-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.

Type: String

Required: Yes when Type is set to select or archive-retrieval.


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


(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 Format field, JSON is the default format.

Valid Values: CSV | JSON

Type: String

Required: no


Input parameters used for a range inventory retrieval.

Type: InventoryRetrievalJobInput object

Required: no


An object that contains information about the location where the select job results are stored.

Type: OutputLocation object

Required: Yes, for select jobs.


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 a 400 response.

An error occurs if you specify this field for an inventory-retrieval or select job request.

Type: String

Required: no


An object that contains information about the parameters used for a select.

Type: SelectParameters object

Required: no


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


The tier to use for a select or an archive retrieval job. Standard is the default value used.

Valid Values: Expedited | Standard | Bulk

Type: String

Required: no


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-retrieval

Type: String

Required: yes

More Info

On this page: