此操作用来查看某Bucket的所有Bucket清单的配置。

请求语法

• 不带continuation-token参数

GET /?inventory HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Authorization: SignatureValue

• 带continuation-token参数

GET /?inventory&continuation-token=continuation-token HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Authorization: SignatureValue

请求头

请求参数

响应结果

名称
描述
ListInventoryConfigurationsResult
整个响应的容器。
类型：容器。
子节点：ContinuationToken、InventoryConfiguration、IsTruncated、NextContinuationToken。
ContinuationToken
本次请求的continuation-token参数。
类型：字符串。
父节点：ListInventoryConfigurationsResult。
InventoryConfiguration
清单配置的容器。
类型：容器。
父节点：ListInventoryConfigurationsResult
子节点：Destination、IsEnabled、Filter、Id、OptionalFields、Schedule。
Destination
存放清单结果的容器。
类型：容器。
父节点：InventoryConfiguration。
子节点：OOSBucketDestination。
OOSBucketDestination
存放清单结果的Bucket信息。
类型：容器。
父节点：Destination。
子节点：Bucket、Format、Prefix。
Bucket
存放清单结果文件的Bucket。
类型：字符串。
父节点：OOSBucketDestination。
Format
清单结果文件的类型。
类型：字符串。
父节点：OOSBucketDestination。
Prefix
清单结果的存储路径前缀。
类型：字符串。
父节点：OOSBucketDestination。
IsEnabled
清单功能是否启用：
true：启用清单功能。
false：不启用清单功能。
类型：布尔型。
父节点：InventoryConfiguration。
Filter
清单筛选的前缀。
类型：容器。
父节点：InventoryConfiguration。
子节点：Prefix。
Prefix
筛选规则的匹配前缀。
类型：字符串。
父节点：Filter。
Id
清单名称。
类型：字符串。
父节点：InventoryConfiguration。
OptionalFields
清单结果配置项的容器。
类型：容器。
父节点：InventoryConfiguration。
子节点：Field。
Field
清单结果中包含配置项：
Size：Object的大小。
LastModifiedDate：Object最后一次修改时间。
ETag：Object的ETag值，用于标识Object的内容。
StorageClass：Object的存储类型。
IsMultipartUploaded：是否为通过分片上传方式上传的Object。
说明
如果未设置配置项，清单默认输出源Bucket和Key（文件名称）。
类型：字符串。
父节点：OptionalFields。
Schedule
存放清单结果导出周期的容器。
类型：容器。
父节点：InventoryConfiguration。
子节点：Frequency。
Frequency
清单结果文件导出的周期：
Daily：按天导出清单结果文件。
Weekly：按周导出清单结果文件。
类型：字符串。
父节点：Schedule。
IsTruncated
是否还有未列举的清单：
true：表示还有未列举的清单。您可以将NextContinuationToken字段的值作为下一次list请求的continuation-token参数，以获取下一页的清单配置列表。
false：表示本次已列举完成所有清单。
类型：布尔型。
父节点：ListInventoryConfigurationsResult。
NextContinuationToken
当响应中的IsTruncated为true，且NextContinuationToken非空时，使用该字段作为下一次list请求的continuation-token参数。
类型：字符串。
父节点：ListInventoryConfigurationsResult。

请求示例

GET /?inventory HTTP/1.1
Host: example-bucket.oos-cn.ctyunapi.cn
Date: Thu, 24 Aug 2023 02:16:10 GMT
Connection: keep-alive
Authorization: SignatureValue

响应示例

HTTP/1.1 200 OK
Content-Type: application/xml;charset=UTF-8
Date: Thu, 24 Aug 2023 02:16:10 GMT
x-amz-request-id: 3332f358e09a430ce53128393f3c3f1e3a362a3e33344d1587
Content-Length: 3938
Server: CTYUN

<?xml version="1.0" encoding="UTF-8"?>
<ListInventoryConfigurationsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <ContinuationToken></ContinuationToken>
  <InventoryConfiguration>
    <Destination>
      <OOSBucketDestination>
        <Bucket>arn:ctyun:oos:::docs</Bucket>
        <Format>CSV</Format>
        <Prefix>0</Prefix>
      </OOSBucketDestination>
    </Destination>
    <Filter>
      <Prefix></Prefix>
    </Filter>
    <Id>0</Id>
    <IsEnabled>true</IsEnabled>
    <OptionalFields>
      <Field>Size</Field>
    </OptionalFields>
    <Schedule>
      <Frequency>Daily</Frequency>
    </Schedule>
  </InventoryConfiguration>
  <InventoryConfiguration>
    <Destination>
      <OOSBucketDestination>
        <Bucket>arn:ctyun:oos:::docs</Bucket>
        <Format>CSV</Format>
        <Prefix>1</Prefix>
      </OOSBucketDestination>
    </Destination>
    <Filter>
      <Prefix></Prefix>
    </Filter>
    <Id>1</Id>
    <IsEnabled>true</IsEnabled>
    <OptionalFields>
      <Field>Size</Field>
    </OptionalFields>
    <Schedule>
      <Frequency>Daily</Frequency>
    </Schedule>
  </InventoryConfiguration>
 
......

  <InventoryConfiguration>
    <Destination>
      <OOSBucketDestination>
        <Bucket>arn:ctyun:oos:::docs</Bucket>
        <Format>CSV</Format>
        <Prefix>9</Prefix>
      </OOSBucketDestination>
    </Destination>
    <Filter>
      <Prefix></Prefix>
    </Filter>
    <Id>9</Id>
    <IsEnabled>true</IsEnabled>
    <OptionalFields>
      <Field>Size</Field>
    </OptionalFields>
    <Schedule>
      <Frequency>Daily</Frequency>
    </Schedule>
  </InventoryConfiguration>
  <IsTruncated>false</IsTruncated>
</ListInventoryConfigurationsResult>