update-bucket-metadata-inventory-table-configuration-对象存储(OSS)-阿里云帮助中心

update-bucket-metadata-inventory-table-configuration命令用于更新Bucket的动态清单表（Live Inventory Table）配置，例如启用或关闭动态清单表。

注意事项

重要

元数据管理（Metadata）当前为邀测功能，尚未对所有用户开放，且仅在已开放Table Bucket的地域提供。如需使用，请联系技术支持申请。此外，您也可以通过OSS控制台开启、修改或关闭元数据管理功能。

阿里云账号默认拥有更新Bucket动态清单表配置的权限。如果您需要通过RAM用户或者STS的方式进行操作，您必须拥有oss:UpdateBucketMetadataInventoryTableConfiguration权限。具体操作，请参见为RAM用户授予自定义的权限策略。

命令格式

ossutil api update-bucket-metadata-inventory-table-configuration --bucket examplebucket --inventory-table-configuration file://inventory-table-configuration.xml

参数	类型	说明
--bucket	string	目标Bucket的名称。
--inventory-table-configuration	string	元数据表配置容器，支持XML和JSON格式。当选项值包含`file://`前缀时，表示从文件中读取配置。

--inventory-table-configuration

--inventory-table-configuration配置选项支持XML和JSON语法，当选项值包含file://前缀时，表示从文件中读取配置。示例配置文件inventory-table-configuration.xml的内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<InventoryTableConfiguration>
  <ConfigurationState>ENABLED</ConfigurationState>
</InventoryTableConfiguration>

等效的JSON语法如下：

{
  "ConfigurationState": "ENABLED"
}

参数	类型	是否必填	说明
ConfigurationState	String	是	动态清单表状态。取值：ENABLED、DISABLED。
EncryptionConfiguration	Container	否	动态清单表加密配置。仅当 ConfigurationState 为 ENABLED 时有效，DISABLED 时传入将返回 400。
EncryptionConfiguration.SseAlgorithm	String	条件必填	加密算法。传入 EncryptionConfiguration 时必填。
EncryptionConfiguration.KmsKeyArn	String	条件必填	KMS 密钥 ARN。SseAlgorithm 为 SSE-KMS 时必填。

说明

本命令需要ossutil 2.4.1及以上版本。更低版本请通过泛化命令invoke-operation调用对应接口。

关于支持的全局命令行选项，请参见支持的全局命令行选项。

使用示例

为Bucket examplebucket 启用动态清单表。配置文件 inventory-table-configuration.xml 的内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<InventoryTableConfiguration>
  <ConfigurationState>ENABLED</ConfigurationState>
</InventoryTableConfiguration>

也可以改用JSON格式的配置文件 inventory-table-configuration.json，内容如下：

{
  "ConfigurationState": "ENABLED"
}

命令示例如下：

ossutil api update-bucket-metadata-inventory-table-configuration --bucket examplebucket --inventory-table-configuration file://inventory-table-configuration.xml

ossutil api update-bucket-metadata-inventory-table-configuration --bucket examplebucket --inventory-table-configuration file://inventory-table-configuration.json