Uploading an Archive in a Single Operation Using the Amazon Command Line Interface - Amazon S3 Glacier
(Prerequisite) Setting Up the Amazon CLIExample: Upload an Archive Using the Amazon CLI
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

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

  1. Download and configure the Amazon CLI. For instructions, see the following topics in the Amazon Command Line Interface User Guide:

    Installing the Amazon Command Line Interface

    Configuring the Amazon Command Line Interface

  2. 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. Replace 123456789012 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.

  1. Use the upload-archive command to add an archive to an existing vault. In the below example replace the vault name and account ID. For the body parameter specify a path to the file you wish to upload.

    aws glacier upload-archive --vault-name awsexamplevault --account-id 123456789012 --body archive.zip

  2. 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.