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

Supported Operations in Glacier

To work with vaults and archives (see Amazon S3 Glacier Data Model), Amazon S3 Glacier (Glacier) supports a set of operations. Among all the supported operations, only the following operations are asynchronous:

  • Retrieving an archive

  • Retrieving a vault inventory (list of archives)

These operations require you to first initiate a job and then download the job output. The following sections summarize the Glacier operations:

Vault Operations

Glacier provides operations to create and delete vaults. You can obtain a vault description for a specific vault or for all vaults in a region. The vault description provides information such as creation date, number of archives in the vault, total size in bytes used by all the archives in the vault, and the date Glacier generated the vault inventory. Glacier also provides operations to set, retrieve, and delete a notification configuration on the vault. For more information, see Working with Vaults in Amazon S3 Glacier.

Archive Operations

Glacier provides operations for you to upload and delete archives. You cannot update an existing archive; you must delete the existing archive and upload a new archive. Note that each time you upload an archive, Glacier generates a new archive ID. For more information, see Working with Archives in Amazon S3 Glacier.


You can initiate a Glacier job to perform a select query on an archive, retrieve an archive, or get an inventory of a vault.

The following are the types of Glacier jobs: