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

Getting Started with Amazon S3 Glacier

In Amazon S3 Glacier (Glacier), a vault is a container for storing archives, and an archive is any object, such as a photo, video, or document that you store in a vault. An archive is the base unit of storage in Glacier. This getting started exercise provides instructions for you to explore basic Glacier operations on the vaults and archives resources described in the Amazon S3 Glacier Data Model section.

In the getting started exercise, you will create a vault, upload and download an archive, and finally delete the archive and the vault. You can do all these operations programmatically. However, the getting started exercise uses the Glacier management console to create and delete a vault. For uploading and downloading an archive, this getting started section uses the AWS Software Development Kits (SDKs) for Java and .NET high-level API. The high-level API provides a simplified programming experience when working with Glacier. For more information about these APIs, see Using the AWS SDKs with Amazon S3 Glacier.

Important

Glacier provides a management console. You can use the console to create and delete vaults as shown in this getting started exercise. However, all other interactions with Glacier require that you use the AWS Command Line Interface (CLI) or write code. 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 by using the AWS SDKs. For more information about using Glacier with the AWS CLI, go to AWS CLI Reference for Glacier. To install the AWS CLI, go to AWS Command Line Interface.

This getting started exercise provides code examples in Java and C# for you to upload and download an archive. The last section of the getting started provides steps where you can learn more about the developer experience with Glacier.