Updated on 2024-01-05 GMT+08:00

Configuring a Bucket Inventory

Procedure

  1. In the navigation pane of OBS Console, choose Object Storage.
  2. In the bucket list, click the bucket you want to operate to go to the Objects page.
  3. In the navigation pane, click Inventories. The inventory list is displayed.
  4. Click Create. The Create Inventory dialog box is displayed.

    Figure 1 Inventory settings

  5. Configure required parameters.

    Table 1 Parameters for configuring a bucket inventory

    Parameter

    Description

    Inventory Name

    Name of a bucket inventory

    Filter

    Filter of an inventory. You can enter an object name prefix for OBS to create an inventory for objects with the specified prefix.

    Currently, only a prefix can be used as a filter. If the filter is not specified, the inventory covers all objects in the bucket.

    If a bucket has multiple inventories, their filters cannot overlap with each other.

    Save Inventory Files To

    Select a bucket (destination bucket) for saving generated inventory files. This bucket must be in the same region as the source bucket.

    Inventory File Name Prefix

    Prefix of the inventory file path.

    An inventory file will be saved in the following path: Inventory file name prefix/Source bucket name/Inventory name/Date and time/files/.

    If this parameter is not specified, OBS automatically adds BucketInventory as the prefix to inventory file's path.

    Frequency

    How frequently inventory files are generated. It can be set to Daily or Weekly.

    Status

    Inventory status. You can enable or disable the generation of inventories.

  6. Click Next to go to the Configure Report page.

    Figure 2 Configuring the report

  7. Configure the report.

    Table 2 Report related parameters

    Parameter

    Description

    Inventory Format

    Inventory files can only be saved in CSV format.

    Object Versions

    Object versions that you want to list in an inventory file. It can be set to Current version only or Include all versions.

    Optional Fields

    Object information fields that can be contained in an inventory file, including Size, Last modified date, Storage class, ETag, Multipart upload, Encryption status, and Replication status. For details about the fields, see Metadata in an Inventory File.

  8. Click Next to confirm the bucket policy.

    OBS then automatically creates a bucket policy on the destination bucket to grant OBS permission to write inventory files to the bucket.

  9. Click OK.