Overview

You can enable inventory for your bucket in the COS Console. The inventory feature allows you to regularly output an inventory report of object attributes and configuration details for your bucket on a daily or weekly basis. For more information about inventory, see Inventory Feature Overview. The following section will guide you through how to enable inventory for a bucket.

• You can configure multiple inventory tasks in one bucket.
• Such tasks do not directly read the object content during their execution; instead, they only scan the attribute information such as object metadata.
• Currently, the inventory feature is not available in Nanjing or Finance Cloud regions.

Prerequisites

A bucket has been created. For details, please see Creating Buckets.

Steps

1. Log in to the COS Console.

2. In the left sidebar, click Bucket List and then click the bucket (source bucket) for which you want to enable inventory.

3. Go to Basic Configurations > Inventory Setting, and click Add Inventory.
   

4. On the Add an Inventory page, you can configure the following items:

   • Inventory Name: Name the output inventory report.
   • Destination Prefix (Optional): Enter the prefix selected for the destination bucket, which can group the inventory files in a public location. The default value is used initially.
   • Destination Bucket: This is the bucket where the inventory is stored. The default value is the source bucket. The destination bucket must be in the same region as the source bucket.
   • Status: You can choose to enable or disable the inventory.
   • Advanced Settings: You can configure more inventory information in the advanced settings. If you leave them alone, all the default settings will be used:
   • Output Format: The default value is CSV format.
   • Object Version: Select whether to include all object versions or only the current version in the inventory. If you do not make a selection, only the current version is included by default.
   • Generation Cycle: Select whether to export the inventory daily or weekly. If you do not make a selection, the report is exported daily by default.
   • Filter Prefix (Optional): filters objects only for those keys starting with the specified prefix. If this field is left empty, no keys will be filtered.
   • Filter time (Optional): filters only objects which are modified after a specified time or within a specified time range. Default: Not setting.
   • Inventory Encryption: Select whether to encrypt the inventory on the server. Options include:
     • No encryption: The inventory is not encrypted. This is the default value.
     • SSE-COS: Encrypt the report using server-side encryption with COS-managed key. For more information, see SSE-COS Encryption in the COS Developer Guide.
   • Inventory Information: Select the object information to be included in the inventory report. Options include object size, storage class, ETag, cross-region replication status, multipart upload status, and last modified date. If you do not make a selection, all items are selected by default.
     

An entity tag (ETag) is a hash of the object. It only reflects changes to the object's content but not the object's metadata. It may or may not be an MD5 digest of the object data. This depends on how the object was created and encrypted.

5. After confirming that the configuration information is correct, click Save.

For more information on the format and content of inventory reports generated by COS inventory, see Inventory Overview.