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

Step 4: Download an Archive from a Vault in Amazon S3 Glacier

In this step, you download the sample archive you uploaded previously in Step 3: Upload an Archive to a Vault in Amazon S3 Glacier.

Important

Any archive operation, such as upload, download, or deletion, requires that you use the AWS Command Line Interface (AWS CLI) or write code. There is no console support for archive operations. For example, to upload data, such as photos, videos, and other documents, you must either use the AWS CLI or write code to make requests, using either the REST API directly or the AWS SDKs. For more information about using Amazon S3 Glacier (Glacier) with the AWS CLI, see AWS CLI Reference for Glacier. To install the AWS CLI, see AWS Command Line Interface.

In general, retrieving your data from Glacier is a two-step process:

  1. Initiate a retrieval job.

  2. After the job completes, download the bytes of data.

To retrieve an archive from Glacier, you first initiate a job. After the job completes, you download the data. For more information about archive retrievals, see Retrieving Glacier Archives.

The access time of your request depends on the retrieval option you choose: Expedited, Standard, or Bulk retrievals. For all but the largest archives (250 MB+), data accessed using Expedited retrievals are typically made available within 1–5 minutes. Archives retrieved using Standard retrievals typically complete between 3–5 hours. Bulk retrievals typically complete within 5–12 hours. For more information about the retrieval options, see the Glacier FAQ. For information about data retrieval charges, see the Glacier detail page.

The code examples shown in the following topics initiate the job, wait for it to complete, and then download the archive's data.