Updated on 2026-11-16 GMT+08:00

InventoryConfiguration

Table 1 InventoryConfiguration

Parameter

Type

Mandatory (Yes/No)

Description

configurationId

String

Yes

Explanation:

ID of a bucket inventory rule.

Restrictions:

The rule ID allows letters (a–z, A–Z), digits (0–9), hyphens (-), underscores (_), and periods (.).

Value range:

The value can be up to 64 characters long.

Default value:

None

isEnabled

boolean

Yes

Explanation:

Whether the bucket inventory rule is enabled.

Value range:

true: The rule is enabled, and inventory files are generated.

false: The rule is disabled. No inventory file is generated.

Default value:

true

objectPrefix

String

No

Explanation:

Prefix for filtering objects. Only objects with the specified name prefix are included in inventory files.

Value range:

The value must contain 1 to 1,024 characters.

Default value:

None

frequency

String

Yes

Explanation:

Intervals when inventories are generated. You can set this parameter to Daily or Weekly. An inventory is generated within one hour from when it is configured for the first time. Then it is generated at the specified intervals.

Value range:

Daily: Inventories are generated once a day.

Weekly: Inventories are generated once a week.

Default value:

None

inventoryFormat

String

Yes

Explanation:

Inventory file format. Only the CSV format is supported.

Value range:

CSV

Default value:

None

destinationBucket

String

Yes

Explanation:

Name of the bucket for storing inventories.

Restrictions:

  • A bucket name must be unique across all accounts and regions.
  • A bucket name:
    • Must be 3 to 63 characters long and start with a digit or letter. Lowercase letters, digits, hyphens (-), and periods (.) are allowed.
    • Cannot be formatted as an IP address.
    • Cannot start or end with a hyphen (-) or period (.).
    • Cannot contain two consecutive periods (..), for example, my..bucket.
    • Cannot contain a period (.) and a hyphen (-) adjacent to each other, for example, my-.bucket or my.-bucket.
  • If you repeatedly create buckets with the same name in the same region, no error will be reported and the bucket properties comply with those set in the first creation request.

Default value:

None

inventoryPrefix

String

No

Explanation:

The prefix of the inventory file name.

Value range:

The value must contain 1 to 1,024 characters.

Default value:

If you do not specify this parameter, BucketInventory is used as the prefix by default.

includedObjectVersions

String

Yes

Explanation:

Whether versions of objects are included in an inventory.

Value range:

  • If this parameter is set to All, all the versions of objects are included in the inventory, and version-related fields are added to the inventory, including: VersionId, IsLatest, and DeleteMarker.
  • If this parameter is set to Current, the inventory only lists information about the current object version and does not include any version-related fields.

Default value:

None

optionalFields

ArrayList<String>

No

Explanation:

Additional object metadata fields that are contained in an inventory file.

Value range:

Size: Object size.

LastModifiedDate: The last time when the object was modified.

StorageClass: The storage class of the object.

ETag: The ETag value of the object.

IsMultipartUploaded: Whether the object was uploaded in a multipart upload.

ReplicationStatus: The cross-region replication status of the object.

EncryptionStatus: The encryption status of the object.

BucketKeyStatus: The bucket key status.

UserMeta: The user-defined metadata.

CRC64: The object's CRC64 value.

ObjectType: The object type.

Default value:

None

filter

Table 2

No

Explanation:

Filter criteria for generating bucket inventories. You can filter objects by object name prefix, whether the object is of the latest version, and whether the object is a delete marker. Multiple filter criteria can be combined using the And operator.

Restrictions:

The filter and objectPrefix parameters are mutually exclusive. If filter is set, it takes precedence. If filter is not set, objectPrefix is used.

Value range:

For details, see Table 2.

Default value:

None

Table 2 InventoryFilter

Parameter

Type

Mandatory (Yes/No)

Description

prefix

String

No

Explanation:

Object name prefix used to filter objects. Only objects with the specified name prefix are included in inventory files.

Value range:

The value must contain 1 to 1,024 characters.

Default value:

Empty string, indicating that objects are not filtered by name prefix.