This page is only for existing customers of the S3 Glacier service using Vaults and the original REST API from 2012.
If you're looking for archival storage solutions we suggest using the S3 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 S3 Glacier storage classes
Uploading an Archive in a Single Operation Using the Amazon Command Line Interface
You can upload an archive in Amazon S3 Glacier (S3 Glacier) using the Amazon Command Line Interface (Amazon CLI).
(Prerequisite) Setting Up the Amazon CLI
-
Download and configure the Amazon CLI. For instructions, see the following topics in the Amazon Command Line Interface User Guide:
-
Verify your Amazon CLI setup by entering the following commands at the command prompt. These commands don't provide credentials explicitly, so the credentials of the default profile are used.
-
Try using the help command.
aws help
-
To get a list of S3 Glacier vaults on the configured account, use the
list-vaults
command. Replace123456789012
with your Amazon Web Services account ID.aws glacier list-vaults --account-id
123456789012
-
To see the current configuration data for the Amazon CLI, use the
aws configure list
command.aws configure list
-
Example: Upload an Archive Using the Amazon CLI
In order to upload an archive you must have a vault created. For more information about creating vaults, see Creating a Vault in Amazon S3 Glacier.
-
Use the
upload-archive
command to add an archive to an existing vault. In the below example replace thevault name
andaccount ID
. For thebody
parameter specify a path to the file you wish to upload.aws glacier upload-archive --vault-name
awsexamplevault
--account-id123456789012
--bodyarchive.zip
-
Expected output:
{ "archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", "checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67", "location": "/123456789012/vaults/awsexamplevault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw" }
When finished the command will output the archive ID, checksum, and location in S3 Glacier. For more information about the upload-archive command, see upload-archive in the Amazon CLI Command Reference.