List Bucket Inventory

List Bucket Inventory用于批量获取某个存储空间（Bucket）中的所有清单（Inventory）任务。使用此接口，需要是Bucket的拥有者或被授予ks3:ListBucketInventory权限的用户。

请求

请求语法

GET /?inventory HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
Content-Type: text/plain

注意：

• endpoint与Region对应关系
• SignatureValue签名算法

请求参数

该请求不使用请求参数。

请求头部

该接口只使用常用请求头部。获取更多信息，请点击公共请求头。

请求内容

该接口不使用请求内容。

响应

响应头部

该接口将返回所有常用响应头部。获取更多信息，请点击公共响应头。

响应内容

参数	描述	是否必选
ListInventoryConfigurationsResult	Bucket中所有清单任务信息的列表 类型：String	是
InventoryConfiguration	存放单个清单任务参数的容器 类型：Container	是
Id	用户指定的清单名称，在单个Bucket下，清单名称唯一 类型：String	是
IsEnabled	清单是否启用 类型：Boolean 有效值：true/false true：清单功能启用 false：清单功能关闭	是
Filter	指定扫描前缀信息 类型：Container	否
Prefix	指定清单扫描的前缀 类型：String 父节点：Filter	否
Destination	存放清单结果 类型：Container	是
KS3BucketDestination	清单结果导出后存放的Bucket信息 类型：Container 父节点：Destination	是
Format	导出清单文件的文件格式 类型：String 有效值：CSV、ORC、Parquet 父节点：KS3BucketDestination	是
Bucket	导出清单文件的Bucket 类型：String 父节点：KS3BucketDestination	是
Prefix	清单文件的存储路径 类型：String 父节点：KS3BucketDestination	否
Schedule	存放清单导出周期信息 类型：Container	是
Frequency	清单文件导出的周期 类型：String 有效值：Once、Daily、Weekly 父节点：Schedule	是
OptionalFields	设置清单结果中应包含的配置项 类型：Container	否
Field	清单结果中包含的配置项 类型：String 可选的配置项：Size、LastModifiedDate、ETag、StorageClass、IsMultipartUploaded、EncryptionStatus 父节点：OptionalFields	否

特殊错误

该接口不返回任何特殊错误。

示例

请求示例

GET /?inventory HTTP/1.1
Host: BucketName.ks3-cn-beijing.ksyun.com
Date: Fri, 24 Feb 2012 03:55:00 GMT
Authorization: authorization string
Content-Type: text/plain

响应示例

HTTP/1.1 200 OK
x-kss-request-id: 56594298207FB3044385****
Date: Sat, 30 Apr 2016 23:29:37 GMT
Content-Type: application/xml
Content-Length: length
Connection: close
Server: ks3
  
<?xml version="1.0" encoding="UTF-8"?>
<ListInventoryConfigurationsResult>
  <InventoryConfiguration">
  <Id>report1</Id>
  <IsEnabled>true</IsEnabled>
  <Destination>
     <KS3BucketDestination>
        <Format>CSV</Format>
        <AccountId>1000000000000000</AccountId>
        <Bucket>examplebucket</Bucket>
        <Prefix>prefix1</Prefix>
     </KS3BucketDestination>
  </Destination>
  <Schedule>
     <Frequency>Daily</Frequency>
  </Schedule>
  <Filter>
    <Prefix>myprefix/</Prefix>
  </Filter>
  <IncludedObjectVersions>All</IncludedObjectVersions>
  <OptionalFields>
     <Field>Size</Field>
     <Field>LastModifiedDate</Field>
     <Field>ETag</Field>
     <Field>StorageClass</Field>
     <Field>IsMultipartUploaded</Field>
     <Field>EncryptionStatus</Field>
  </OptionalFields>
 </InventoryConfiguration>
 <InventoryConfiguration">
  <Id>report1</Id>
  <IsEnabled>true</IsEnabled>
  <Destination>
     <KS3BucketDestination>
        <Format>CSV</Format>
        <AccountId>1000000000000000</AccountId>
        <Bucket>examplebucket</Bucket>
        <Prefix>prefix1</Prefix>
        <Encryption>
           <SSE-KS3/>
        </Encryption>
     </KS3BucketDestination>
  </Destination>
  <Schedule>
     <Frequency>Daily</Frequency>
  </Schedule>
  <Filter>
    <Prefix>myprefix/</Prefix>
  </Filter>
  <IncludedObjectVersions>All</IncludedObjectVersions>
  <OptionalFields>
     <Field>Size</Field>
     <Field>LastModifiedDate</Field>
     <Field>ETag</Field>
     <Field>StorageClass</Field>
     <Field>IsMultipartUploaded</Field>
     <Field>EncryptionStatus</Field>
  </OptionalFields>
  </InventoryConfiguration>
  <IsTruncated>true</IsTruncated>
  <NextContinuationToken>...</NextContinuationToken>
</ListInventoryConfigurationsResult>