ListBucketInventory
ListBucketInventory用于批量獲取某個存儲空間(Bucket)中的所有清單(Inventory)任務(wù)。
單次請求最多可獲取100條清單配置項內(nèi)容。若需獲取超過100條清單配置項,則需發(fā)送多次請求,并保留相應(yīng)的token,作為下一次請求的參數(shù)。
調(diào)用該請求時,請確保您有足夠的權(quán)限對存儲空間的清單任務(wù)進(jìn)行操作。存儲空間所有者默認(rèn)擁有該權(quán)限,若您無該項權(quán)限,請先向存儲空間所有者申請該項操作的權(quán)限。
請求語法
帶continuation-token的形式
GET /?inventory&continuation-token=xxx HTTP/1.1
不帶continuation-token的形式
GET /?inventory HTTP/1.1
響應(yīng)元素
名稱 | 類型 | 描述 |
InventoryConfiguration | 容器 | 存放清單配置參數(shù)的容器。 |
IsTruncated | 布爾 | 是否列舉全部的清單任務(wù)。 有效值:true或false
|
NextContinuationToken | 字符串 | 當(dāng)響應(yīng)中的IsTruncated為true且NextContinuationToken非空時,使用該字段作為下一次list請求的continuation-token參數(shù)。 |
Id | 字符串 | 由用戶指定的清單名稱,清單名稱在當(dāng)前存儲空間下必須全局唯一。 |
IsEnabled | 布爾 | 清單是否啟用的標(biāo)識。 有效值:true或false
|
Filter | 容器 | 清單篩選的前綴。指定前綴后,清單將篩選出符合前綴設(shè)置的對象。 |
Prefix | 字符串 | 篩選規(guī)則的匹配前綴。 父節(jié)點:Filter |
Destination | 容器 | 存放清單結(jié)果的信息。 |
OSSBucketDestination | 容器 | 清單結(jié)果導(dǎo)出后存放的存儲空間信息。 父節(jié)點:Destination |
Format | 字符串 | 導(dǎo)出清單文件的文件格式。 有效值:CSV 父節(jié)點:OSSBucketDestination |
AccountId | 字符串 | 存儲空間所有者授予的賬戶ID。 父節(jié)點:OSSBucketDestination |
RoleArn | 字符串 | 存儲空間所有者授予操作權(quán)限的角色名。 格式為:acs:ram::uid:role/rolename 父節(jié)點:OSSBucketDestination |
Bucket | 字符串 | 存放導(dǎo)出的清單文件的存儲空間。 父節(jié)點:OSSBucketDestination |
Prefix | 字符串 | 清單文件的存儲路徑前綴。 父節(jié)點:OSSBucketDestination |
Encryption | 容器 | 清單文件的加密方式。 有效值:SSE-OSS、SSE-KMS或Null 父節(jié)點:OSSBucketDestination |
SSE-OSS | 容器 | SSE-OSS加密方式的容器。 父節(jié)點:Encryption |
SSE-KMS | 容器 | 用于保存SSE-KMS加密方式下的密鑰的容器。 父節(jié)點:Encryption |
KeyId | 字符串 | KMS密鑰id。 父節(jié)點:SSE-KMS |
Schedule | 容器 | 存放清單導(dǎo)出周期信息的容器。 |
Frequency | 字符串 | 清單文件導(dǎo)出的周期。 有效值:Daily或Weekly 父節(jié)點:Schedule |
IncludedObjectVersions | 字符串 | 是否在清單中包含Object版本信息。 有效值:All或Current
|
OptionalFields | 容器 | 設(shè)置清單結(jié)果中應(yīng)包含的配置項。 |
Field | 容器 | 清單結(jié)果中包含的配置項。 可選的配置項:Size、LastModifiedDate、ETag、StorageClass、IsMultipartUploaded、EncryptionStatus 父節(jié)點:OptionalFields |
示例
請求示例
GET /?inventory HTTP/1.1 Host: BucketName.oss.aliyuncs.com Date: Fri, 24 Feb 2012 03:55:00 GMT Authorization: authorization string Content-Type: text/plain
返回示例
HTTP/1.1 200 OK x-oss-request-id: 56594298207FB304438516F9 Date: Sat, 30 Apr 2016 23:29:37 GMT Content-Type: application/xml Content-Length: length Connection: close Server: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <ListInventoryConfigurationsResult> <InventoryConfiguration> <Id>report1</Id> <IsEnabled>true</IsEnabled> <Destination> <OSSBucketDestination> <Format>CSV</Format> <AccountId>1000000000000000</AccountId> <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn> <Bucket>acs:oss:::destination-bucket</Bucket> <Prefix>prefix1</Prefix> </OSSBucketDestination> </Destination> <Schedule> <Frequency>Daily</Frequency> </Schedule> <Filter> <Prefix>prefix/One</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>report2</Id> <IsEnabled>true</IsEnabled> <Destination> <OSSBucketDestination> <Format>CSV</Format> <AccountId>1000000000000000</AccountId> <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn> <Bucket>acs:oss:::destination-bucket</Bucket> <Prefix>prefix2</Prefix> </OSSBucketDestination> </Destination> <Schedule> <Frequency>Daily</Frequency> </Schedule> <Filter> <Prefix>prefix/Two</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>report3</Id> <IsEnabled>true</IsEnabled> <Destination> <OSSBucketDestination> <Format>CSV</Format> <AccountId>1000000000000000</AccountId> <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn> <Bucket>acs:oss:::destination-bucket</Bucket> <Prefix>prefix3</Prefix> </OSSBucketDestination> </Destination> <Schedule> <Frequency>Daily</Frequency> </Schedule> <Filter> <Prefix>prefix/Three</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>