此操作用來查看某Bucket中指定清單配置。
請求語法
GET /?inventory&id=id HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Authorization: SignatureValue
請求頭
| 名稱 | 描述 | 是否必須 |
|---|---|---|
| Id | 清單名稱。 類型：字符串。 取值：只允許使用小寫字母、數字、短橫線（-）和下劃線（_），且不能以短橫線（-）或下劃線（_）開頭或結尾，1~64個字符。 |
是 |
請求參數
| 名稱 | 描述 | 是否必須 |
|---|---|---|
| BucketName | 存儲桶名稱。 | 是 |
響應結果
名稱 描述 InventoryConfiguration 清單配置的容器。
類型：容器。
子節點：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。
請求示例
GET /?inventory&id=1 HTTP/1.1
Date: Wed, 23 Aug 2023 07:09:10 GMT
Host: example-bucket.oos-cn.ctyunapi.cn
Connection: keep-alive
Authorization: SignatureValue
響應示例
HTTP/1.1 200 OK
Content-Type: application/xml;charset=UTF-8
Date: Wed, 23 Aug 2023 07:09:10 GMT
x-amz-request-id: 684a29525fcc40123ebab1c2c8c5c8a7c3bfb3c7bcbdd6c1ac
Content-Length: 466
Server: CTYUN
<?xml version="1.0" encoding="UTF-8"?>
<InventoryConfiguration xmlns="//s3.amazonaws.com/doc/2006-03-01/">
<Destination>
<OOSBucketDestination>
<Bucket>arn:ctyun:oos:::docs</Bucket>
<Format>CSV</Format>
<Prefix>Inventory-</Prefix>
</OOSBucketDestination>
</Destination>
<Filter>
<Prefix></Prefix>
</Filter>
<Id>1</Id>
<IsEnabled>true</IsEnabled>
<OptionalFields>
<Field>Size</Field>
</OptionalFields>
<Schedule>
<Frequency>Daily</Frequency>
</Schedule>
</InventoryConfiguration>
