Amazon Simple Storage Service
Console User Guide

How Do I Configure Amazon S3 Inventory?

Amazon S3 inventory provides a flat file list of your objects and metadata, which is a scheduled alternative to the Amazon S3 synchronous List API operation. Amazon S3 inventory provides a comma-separated values (.csv) flat-file output of your objects and their corresponding metadata on a daily or weekly basis for an S3 bucket or for objects that share a prefix (objects that have names that begin with the same string). For more information, see Amazon S3 Inventory in the Amazon Simple Storage Service Developer Guide.

To configure inventory

  1. Sign in to the AWS Management Console and open the Amazon S3 console at

  2. In the Bucket name list, choose the name of the bucket for which you want to configure Amazon S3 inventory.

  3. Choose the Management tab, and then choose Inventory.

  4. Choose Add new if you do not have any inventory reports enabled.

  5. Type a name for the inventory and set it up as follows:

    • Optionally, add a prefix for your filter to inventory only objects whose names begin with the same string.

    • Choose the destination bucket where you want reports to be saved. The destination bucket must be in the same AWS Region as the bucket for which you are setting up the inventory. The destination bucket can be in a different AWS account.

    • Optionally, choose a prefix for the destination bucket.

    • Choose how frequently to generate the inventory.

  6. Under Advanced Settings you can set the following.

    1. To include all versions of the objects in the inventory, choose Include All Versions from the Object Versions menu. By default the inventory includes only the current version of the objects.

    2. Select one or more of the following optional fields to add to the inventory report:

      • Size – Object size in bytes.

      • Last modified date – Object creation date or the last modified date, whichever is the latest.

      • Storage class – Storage class used for storing the object.

      • ETag – The entity tag is a hash of the object. The ETag reflects changes only to the contents of an object, not its metadata. The ETag may or may not be an MD5 digest of the object data. Whether or not it is depends on how the object was created and how it is encrypted.

      • Replication status – The Cross Region Replication status of the object. For more information, see How Do I Add a Cross-Region Replication Rule to an S3 Bucket?.

  7. Choose Save.

Amazon S3 creates a bucket policy on the destination bucket that grants Amazon S3 write permission. This allows Amazon S3 to write data for the inventory reports to the bucket.

If an error occurs when you try to create the bucket policy, you'll be given instructions on how to fix it. For example, if you chose a destination bucket in another AWS account and do not have permissions to read and write to the bucket policy, you see the following message. In this case you must have the destination bucket owner add the displayed bucket policy to the destination bucket. If the policy is not added to the destination bucket you won’t get an inventory report because Amazon S3 doesn’t have permission to write to the destination bucket. If the source bucket is owned by a different account than that of the current user, then the correct account ID of the source bucket must be substituted in the policy.

For more information, see Amazon S3 Inventory in the Amazon Simple Storage Service Developer Guide.

More Info

Storage Management