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