文档中心

对象存储

桶清单

GetBucketInventory

GetBucketInventory

功能描述

此接口用于查看某个存储桶中指定桶清单规则。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
inventory	Query	String	是	-	代表 GetBucketInventory 请求的特殊标识。
id	Query	String	是	report	桶清单名称,通过 PutBucketInventory 接口获取

请求元素

该请求不使用消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

名称	参数类型	示例值	说明
InventoryConfiguration	Object	-	桶清单规则。
Id	String	report	桶清单名称。
IsEnabled	Boolean	true	是否启用桶清单功能。取值如下： true：启用桶清单功能。 false：不启用桶清单功能。
Destination	Array	-	清单文件的相关信息。
TOSBucketDestination	Array	-	清单文件的存储桶相关信息。父节点：Destination
Role	String	TosArchiveTOSInventory	角色名称，用于授予对象存储读取源存储桶所有文件和向目标存储桶写入文件的权限。该角色必须具有 TOS 的读写权限及服务访问权限，您也可以使用 TOS 默认角色 TosArchiveTOSInventory。
Format	String	CSV	清单文件的格式。取值CSV，即清单文件的格式为使用 GZIP 压缩后的 CSV 格式。父节点：TOSBucketDestination
AccountId	String	200000****	存储桶所有者的账号 ID。父节点：TOSBucketDestination
Bucket	String	bucket_0001	保存清单文件的存储桶。父节点：TOSBucketDestination
Prefix	String	prefix1	清单文件的存储路径前缀。父节点：TOSBucketDestination
Schedule	Array	-	桶清单导出周期信息。
Frequency	String	Daily	清单文件导出的周期。取值如下： Daily：按天导出清单文件。 Weekly：按周导出清单文件。 Once：一次性导出清单文件。父节点：Schedule
Instant	Bool	true	是否启用即时清单功能。取值如下： true：启用即时清单功能。 false：不启用即时清单功能。父节点：Schedule
IncludedObjectVersions	String	All	导出的对象版本。取值如下： All：导出所有版本的对象信息。 Current：导出当前版本的对象信息。
Filter	Array	-	桶清单筛选的前缀。指定前缀后，桶清单将导出符合前缀设置的对象。
Prefix	String	Pics/	导出文件前缀匹配信息，如果不设置，默认生成桶中所有对象的清单。父节点：Filter
OptionalFields	Array	-	清单文件导出的信息。
Field	String	Size	清单文件需要导出的信息。支持多选，取值如下： Size：对象的大小。 LastModifiedDate：对象的最后修改时间。 ETag：对象的 ETag 值，用于标识对象的内容。 StorageClass：对象的存储类型。 IsMultipartUploaded：是否为通过分片上传方式上传的对象。 EncryptionStatus：对象是否加密。 CRC64：对象的 CRC64 值。 ReplicationStatus：对象的跨区域复制或同区域复制状态。 Tag：对象标签。 RetentionMode：保留模式。 RetainUntilTimestamp：保留到期时间。父节点：OptionalFields

请求示例

响应示例

最近更新时间：2026.10.21 16:29:34

这个页面对您有帮助吗？

有用

有用

无用

无用