GetBucketInventory用於查看某個儲存空間(Bucket)中指定的清單(Inventory)任務。
注意事項
阿里雲帳號預設擁有查看Bucket指定清單任務的許可權。如果您需要通過RAM使用者或者STS的方式進行查看,您必須擁有oss:GetBucketInventory
許可權。
請求文法
GET /?inventory&inventoryId=inventoryId HTTP/1.1
請求元素
名稱 | 類型 | 是否必選 | 描述 |
inventoryId | 字串 | 是 | 查詢的清單規則Id。 |
響應元素
名稱 | 類型 | 描述 |
Id | 字串 | 由使用者指定的清單名稱,清單名稱在當前儲存空間下必須全域唯一。 |
IsEnabled | 布爾 | 清單是否啟用的標識。 有效值:true或false
|
Filter | 容器 | 清單篩選的首碼。指定首碼後,清單將篩選出符合首碼設定的對象。 |
Prefix | 字串 | 篩選規則的匹配首碼。 父節點:Filter |
Destination | 容器 | 存放清單結果的資訊。 |
OSSBucketDestination | 容器 | 清單結果匯出後存放的儲存空間資訊。 父節點:Destination |
Format | 字串 | 匯出資訊清單檔的檔案格式。 有效值:CSV 父節點:OSSBucketDestination |
AccountId | 字串 | 儲存空間所有者授予的賬戶ID。 父節點:OSSBucketDestination |
RoleArn | 字串 | 儲存空間所有者授予操作許可權的角色名稱。 格式為:acs:ram::uid:role/rolename 父節點:OSSBucketDestination |
Bucket | 字串 | 存放匯出的資訊清單檔的儲存空間。 父節點:OSSBucketDestination |
Prefix | 字串 | 資訊清單檔的儲存路徑首碼。 父節點:OSSBucketDestination |
Encryption | 容器 | 資訊清單檔的加密方式。 有效值:SSE-OSS、SSE-KMS或空 父節點:OSSBucketDestination |
SSE-OSS | 容器 | SSE-OSS加密方式的容器。 父節點:Encryption |
SSE-KMS | 容器 | 用於儲存SSE-KMS加密方式下的密鑰的容器。 父節點:Encryption |
KeyId | 字串 | KMS密鑰id。 父節點:SSE-KMS |
Schedule | 容器 | 存放清單匯出周期資訊的容器。 |
Frequency | 字串 | 資訊清單檔匯出的周期。 有效值:Daily或Weekly 父節點:Schedule |
IncludedObjectVersions | 字串 | 是否在清單中包含Object版本資訊。 有效值:All或Current
|
OptionalFields | 容器 | 設定清單結果中應包含的配置項。 |
Field | 字串 | 清單結果中包含的配置項。 可選的配置項:Size、LastModifiedDate、ETag、StorageClass、IsMultipartUploaded、EncryptionStatus 父節點:OptionalFields |
樣本
請求樣本
GET /?inventory&inventoryId=list1 HTTP/1.1
返回樣本
HTTP/1.1 200 OK x-oss-request-id: 56594298207FB304438516F9 Date: Mon, 31 Oct 2016 12:00:00 GMT Server: AliyunOSS Content-Length: length <?xml version="1.0" encoding="UTF-8"?> <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:::bucket_0001</Bucket> <Prefix>prefix1</Prefix> <Encryption> <SSE-OSS/> </Encryption> </OSSBucketDestination> </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>