此操作用來查看某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="//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>