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>