How do I use the AWS CLI to view the contents of an S3 Glacier vault?

2 minute read

I want to check the contents of an Amazon Simple Storage Service (Amazon S3) Glacier vault.


Use the following AWS Command Line Interface (AWS CLI) commands to check the contents of your Amazon S3 Glacier vaults.

Before you begin, configure the AWS CLI. If you receive errors when running AWS CLI commands, make sure that you’re using the most recent version of the AWS CLI.

  • To list the vaults in your AWS account, run the list-vaults command.
    Note: If you don't see any vaults listed, run the configure command. Confirm that the correct AWS Region is configured for the AWS CLI.
  • To request an inventory of a specific vault, run the initiate-job command and include the option --job-parameters '{"Type": "inventory-retrieval"}'.
    Note: The job run time varies depending on the retrieval type. For more information, see Archive retrieval options.
  • To view the status of a job, run the describe-job command.
  • To download the output of a job, run the get-job-output command.

For a list of all available commands, see the AWS CLI command reference for Amazon S3 Glacier.

Related information

Using Amazon S3 Glacier with the AWS CLI

Amazon S3 Glacier data retrieval policies

Set data retrieval policy (PUT policy)

AWS OFFICIALUpdated 3 years ago