GetBucketMetadataConfiguration-对象存储(OSS)-阿里云帮助中心

调用GetBucketMetadataConfiguration接口查询通用型 Bucket 的元数据管理（Metadata）功能配置详情，包括元数据存储位置、变更日志表（Journal Table）和动态清单表（Live Inventory Table）的状态与配置。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的 RAM 用户或 RAM 角色默认没有任何权限，需要阿里云账号或账号管理员授予操作权限。

API	Action	说明
GetBucketMetadataConfiguration	`oss:GetBucketMetadataTableConfiguration`	查询元数据管理功能配置。

请求语法

GET /?metadataConfiguration HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

请求头

名称	类型	是否必选	描述
x-oss-expected-bucket-owner	字符串	否	预期的 Bucket 拥有者账号 ID。

响应元素

名称	类型	描述
DestinationResult.TableBucketArn	字符串	托管 Table Bucket 的 ARN。
DestinationResult.TableBucketType	字符串	Table Bucket 类型。
DestinationResult.TableNamespace	字符串	元数据表所在的 Namespace 名称。
JournalTableConfigurationResult.TableStatus	字符串	变更日志表状态。取值：CREATING、ACTIVE、FAILED。
JournalTableConfigurationResult.TableName	字符串	变更日志表名称，固定为 journal。
JournalTableConfigurationResult.TableArn	字符串	变更日志表的 ARN。仅在 ACTIVE 状态下存在。
JournalTableConfigurationResult.Error	容器	错误信息。仅在 FAILED 状态下存在，包含 ErrorCode 和 ErrorMessage。
JournalTableConfigurationResult.RecordExpiration.Expiration	字符串	记录过期开关。取值：ENABLED、DISABLED。
JournalTableConfigurationResult.RecordExpiration.Days	整数	记录过期天数。仅在 Expiration 为 ENABLED 时存在。
InventoryTableConfigurationResult.ConfigurationState	字符串	动态清单表启用状态。取值：ENABLED、DISABLED。
InventoryTableConfigurationResult.TableStatus	字符串	动态清单表状态。仅在 ConfigurationState 为 ENABLED 时存在。取值：CREATING、BACKFILLING、ACTIVE、FAILED。
InventoryTableConfigurationResult.TableName	字符串	动态清单表名称。仅在 ENABLED 时存在，固定为 inventory。
InventoryTableConfigurationResult.TableArn	字符串	动态清单表的 ARN。仅在 BACKFILLING、ACTIVE 状态下存在。
InventoryTableConfigurationResult.Error	容器	错误信息。仅在 FAILED 状态下存在，包含 ErrorCode 和 ErrorMessage。

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

示例

请求示例

GET /?metadataConfiguration HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 16 Sep 2026 12:00:00 GMT
Authorization: SignatureValue

返回示例

HTTP/1.1 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<GetBucketMetadataConfigurationResult>
   <MetadataConfigurationResult>
      <DestinationResult>
         <TableBucketArn>acs:oss:cn-hangzhou:123456789012****:table-bucket/oss-managed-table-bucket</TableBucketArn>
         <TableBucketType>oss-managed</TableBucketType>
         <TableNamespace>b_examplebucket</TableNamespace>
      </DestinationResult>
      <JournalTableConfigurationResult>
         <TableStatus>ACTIVE</TableStatus>
         <TableName>journal</TableName>
         <TableArn>acs:oss:cn-hangzhou:123456789012****:table/b_examplebucket/journal</TableArn>
         <RecordExpiration>
            <Expiration>ENABLED</Expiration>
            <Days>7</Days>
         </RecordExpiration>
      </JournalTableConfigurationResult>
      <InventoryTableConfigurationResult>
         <ConfigurationState>ENABLED</ConfigurationState>
         <TableStatus>ACTIVE</TableStatus>
         <TableName>inventory</TableName>
         <TableArn>acs:oss:cn-hangzhou:123456789012****:table/b_examplebucket/inventory</TableArn>
      </InventoryTableConfigurationResult>
   </MetadataConfigurationResult>
</GetBucketMetadataConfigurationResult>

SDK

GetBucketMetadataConfiguration 接口所对应的各语言 SDK 如下：

命令行工具ossutil

GetBucketMetadataConfiguration 接口所对应的 ossutil 命令，请参见get-bucket-metadata-configuration。