調用GetBucketInfo接口查看存儲空間(Bucket)的相關信息。
注意事項
該請求可以從任何一個OSS的Endpoint發起。
阿里云賬號默認擁有查看Bucket相關信息的權限。如果您需要通過RAM用戶或者STS的方式進行查看,您必須擁有
oss:GetBucketInfo
權限。具體操作,請參見為RAM用戶授權自定義的權限策略。
請求語法
GET /?bucketInfo HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
當您在OSS ON云盒中調用該接口時,您需要將Host替換為云盒Endpoint。更多信息,請參見云盒Endpoint。
請求頭
此接口僅涉及公共請求頭。更多信息,請參見公共請求頭(Common Request Headers)。
響應頭
此接口僅涉及公共響應頭。更多信息,請參見公共響應頭(Common Response Headers)。
響應元素
名稱 | 類型 | 示例值 | 描述 |
BucketInfo | 容器 | 不涉及 | 保存Bucket信息的容器。 子節點:Bucket 父節點:無 |
Bucket | 容器 | 不涉及 | 保存Bucket信息的容器。 父節點:BucketInfo |
CreationDate | 時間 | 2013-07-31T10:56:21.000Z | Bucket的創建時間,格式為UTC時間。 父節點:BucketInfo.Bucket |
ExtranetEndpoint | 字符串 | oss-cn-hangzhou.aliyuncs.com | 外網Endpoint。 父節點:BucketInfo.Bucket |
IntranetEndpoint | 字符串 | oss-cn-hangzhou-internal.aliyuncs.com | 內網Endpoint。 父節點:BucketInfo.Bucket |
Location | 字符串 | oss-cn-hangzhou | Bucket所在地域,格式為OSS專用Region ID。 父節點:BucketInfo.Bucket |
StorageClass | 字符串 | Standard | Bucket的存儲類型。 有效值:Standard、IA、Archive和ColdArchive 關于存儲類型的更多信息,請參見存儲類型概述。 |
Name | 字符串 | oss-example | Bucket名稱。 父節點:BucketInfo.Bucket |
ResourceGroupId | 字符串 | rg-aek27tc******** | Bucket所屬的資源組ID。 如果Bucket屬于默認資源組,則返回值為rg-default-id。 父節點:BucketInfo.Bucket |
Owner | 容器 | 不涉及 | 存放Bucket擁有者信息的容器。 父節點:BucketInfo.Bucket |
ID | 字符串 | 27183473914**** | Bucket擁有者的用戶ID。 父節點:BucketInfo.Bucket.Owner |
DisplayName | 字符串 | username | Bucket擁有者的名稱(目前和用戶ID一致)。 父節點:BucketInfo.Bucket.Owner |
AccessControlList | 容器 | 不涉及 | 存放Bucket讀寫權限(ACL)信息的容器。 關于Bucket ACL的更多信息,請參見設置Bucket ACL。 父節點:BucketInfo.Bucket |
Grant | 枚舉字符串 | private | Bucket的ACL權限。 有效值:private、public-read、public-read-write 父節點:BucketInfo.Bucket.AccessControlList |
DataRedundancyType | 枚舉字符串 | LRS | Bucket的數據容災類型。 有效值:LRS、ZRS 父節點:BucketInfo.Bucket |
Versioning | 字符串 | Enabled | Bucket的版本控制狀態。 有效值:Enabled、Suspended 關于版本控制狀態的更多信息,請參見PutBucketVersioning。 父節點:BucketInfo.Bucket |
ServerSideEncryptionRule | 容器 | 不涉及 | 服務器端加密方式的容器。 關于服務器端加密方式的更多信息,請參見服務器端加密。 父節點:BucketInfo.Bucket |
SSEAlgorithm | 字符串 | KMS | 顯示服務器端默認加密方式。 有效值:KMS、AES256 父節點:BucketInfo.Bucket.ServerSideEncryptionRule |
KMSMasterKeyID | 字符串 | ****** | 顯示當前使用的KMS密鑰ID。僅當SSEAlgorithm為KMS,且指定了密鑰ID時返回取值。其他情況下,返回為空。 父節點:BucketInfo.Bucket.ServerSideEncryptionRule |
KMSDataEncryption | 字符串 | SM4 | 指定 Object 的加密算法。如果未指定此選項,表明 Object 使用 AES256 加密算法。此選項僅當 SSEAlgorithm 取值為 KMS 有效。 父節點:BucketInfo.Bucket.ServerSideEncryptionRule |
CrossRegionReplication | 字符串 | Disabled | 顯示Bucket的跨區域復制狀態。 有效值:Enabled、Disabled 父節點:BucketInfo.Bucket |
TransferAcceleration | 字符串 | Disabled | 顯示Bucket的傳輸加速狀態。 有效值:Enabled、Disabled 父節點:BucketInfo.Bucket |
AccessMonitor | 字符串 | Enabled | 顯示Bucket的訪問跟蹤狀態。 有效值:Enabled、Disabled 父節點:BucketInfo.Bucket |
BucketPolicy | 容器 | 不涉及 | 存放日志信息的容器。 父節點:BucketInfo.Bucket |
LogBucket | 字符串 | examplebucket | 存儲日志記錄的Bucket名稱。 父節點:BucketInfo.Bucket.BucketPolicy |
LogPrefix | 字符串 | log/ | 存儲日志文件的目錄。 父節點:BucketInfo.Bucket.BucketPolicy |
BlockPublicAccess | 布爾值 | true | 獲取Bucket阻止公共訪問的配置信息。
|
示例
請求示例
Get /?bucketInfo HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Sat, 12 Sep 2015 07:51:28 GMT
Authorization: OSS qn6q**************:77Dv****************
返回示例
成功獲取Bucket信息的返回示例
HTTP/1.1 200 x-oss-request-id: 534B371674E88A4D8906**** Date: Sat, 12 Sep 2015 07:51:28 GMT Connection: keep-alive Content-Length: 531 Server: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <BucketInfo> <Bucket> <AccessMonitor>Enabled</AccessMonitor> <CreationDate>2013-07-31T10:56:21.000Z</CreationDate> <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint> <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint> <Location>oss-cn-hangzhou</Location> <StorageClass>Standard</StorageClass> <TransferAcceleration>Disabled</TransferAcceleration> <CrossRegionReplication>Disabled</CrossRegionReplication> <Name>oss-example</Name> <ResourceGroupId>rg-aek27tc********</ResourceGroupId> <Owner> <DisplayName>username</DisplayName> <ID>27183473914****</ID> </Owner> <AccessControlList> <Grant>private</Grant> </AccessControlList> <Comment>test</Comment> <BucketPolicy> <LogBucket>examplebucket</LogBucket> <LogPrefix>log/</LogPrefix> </BucketPolicy> <BlockPublicAccess>true</BlockPublicAccess> </Bucket> </BucketInfo>
獲取不存在的Bucket信息的返回示例
HTTP/1.1 404 x-oss-request-id: 534B371674E88A4D8906**** Date: Sat, 12 Sep 2015 07:51:28 GMT Connection: keep-alive Content-Length: 308 Server: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <Error> <Code>NoSuchBucket</Code> <Message>The specified bucket does not exist.</Message> <RequestId>568D547F31243C673BA1****</RequestId> <HostId>nosuchbucket.oss.aliyuncs.com</HostId> <BucketName>nosuchbucket</BucketName> <EC>0015-00000101</EC> </Error>
獲取沒有權限訪問的Bucket信息的返回示例
HTTP/1.1 403 x-oss-request-id: 534B371674E88A4D8906**** Date: Sat, 12 Sep 2015 07:51:28 GMT Connection: keep-alive Content-Length: 209 Server: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <Error> <Code>AccessDenied</Code> <Message>AccessDenied</Message> <RequestId>568D5566F2D0F89F5C0E****</RequestId> <HostId>test.oss.aliyuncs.com</HostId> </Error>
SDK
此接口對應的各語言SDK如下:
錯誤碼
錯誤碼 | HTTP狀態碼 | 描述 |
NoSuchBucket | 404 | 目標Bucket不存在。 |
AccessDenied | 403 | 沒有查看該Bucket信息的權限。只有Bucket的擁有者才能查看Bucket的信息。 |