调用UpdateBucketMetadataInventoryTableConfiguration接口启用或禁用元数据管理（Metadata）配置中的动态清单表（Live Inventory Table）。
权限说明
阿里云账号默认拥有全部权限。阿里云账号下的 RAM 用户或 RAM 角色默认没有任何权限，需要阿里云账号或账号管理员授予操作权限。
|
API |
Action |
说明 |
|
UpdateBucketMetadataInventoryTableConfiguration |
|
启用或禁用动态清单表。 |
启用动态清单表时，OSS 需要创建并管理托管表资源，因此还需具备以下依赖权限：
-
osstables:CreateTableBucket -
osstables:CreateNamespace -
osstables:GetTable -
osstables:CreateTable -
osstables:PutTablePolicy -
osstables:PutTableEncryption -
kms:DescribeKey
请求语法
PUT /?metadataInventoryTable HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Content-Length: ContentLength
Content-MD5: MD5Value
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<InventoryTableConfiguration>
<ConfigurationState>ENABLED</ConfigurationState>
<EncryptionConfiguration>
<SseAlgorithm>SSE-KMS</SseAlgorithm>
<KmsKeyArn>acs:kms:cn-hangzhou:123456789012****:key/key-id</KmsKeyArn>
</EncryptionConfiguration>
</InventoryTableConfiguration>请求头
|
名称 |
类型 |
是否必选 |
描述 |
|
Content-MD5 |
字符串 |
否 |
请求体的 MD5 校验值。 |
|
x-oss-expected-bucket-owner |
字符串 |
否 |
预期的 Bucket 拥有者账号 ID。 |
请求元素
|
名称 |
类型 |
是否必选 |
描述 |
|
ConfigurationState |
字符串 |
是 |
动态清单表启用状态。取值：ENABLED、DISABLED。 父节点：InventoryTableConfiguration |
|
EncryptionConfiguration |
容器 |
否 |
动态清单表的加密配置。仅在 ConfigurationState 为 ENABLED 时有效；当 ConfigurationState 为 DISABLED 时传入将返回 400。 父节点：InventoryTableConfiguration |
|
EncryptionConfiguration.SseAlgorithm |
字符串 |
条件必选 |
加密算法。传入 EncryptionConfiguration 时必选。 父节点：EncryptionConfiguration |
|
EncryptionConfiguration.KmsKeyArn |
字符串 |
条件必选 |
KMS 密钥 ARN。当 SseAlgorithm 为 SSE-KMS 时必选。 父节点：EncryptionConfiguration |
响应
操作成功时返回 HTTP 状态码 200，响应体为空。
状态约束
启用（Enable）操作：
-
变更日志表必须不处于 CREATING 状态（ACTIVE 和 FAILED 均允许）。
-
动态清单表当前必须为 DISABLED，否则返回 400。
禁用（Disable）操作：
-
若已是 DISABLED，则幂等返回 200。
-
动态清单表处于 CREATING 时拒绝（400）；BACKFILLING、ACTIVE、FAILED 均允许。
若动态清单表处于 FAILED 状态需要重新启用，请先执行 Disable 并删除旧表后，再执行 Enable。
响应头
此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。
示例
-
请求示例
PUT /?metadataInventoryTable HTTP/1.1 Host: examplebucket.oss-cn-hangzhou.aliyuncs.com Date: Wed, 16 Sep 2026 12:00:00 GMT Authorization: SignatureValue <?xml version="1.0" encoding="UTF-8"?> <InventoryTableConfiguration> <ConfigurationState>ENABLED</ConfigurationState> </InventoryTableConfiguration> -
返回示例
HTTP/1.1 200 OK
SDK
UpdateBucketMetadataInventoryTableConfiguration 接口所对应的各语言 SDK 如下：
命令行工具ossutil
UpdateBucketMetadataInventoryTableConfiguration 接口所对应的 ossutil 命令，请参见update-bucket-metadata-inventory-table-configuration。