1022 微信

GetBucketInfo__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲

Get Bucket Info操作用於查看bucket的相關信息。包括如下內容：

創建時間
外網訪問Endpoint
內網訪問Endpoint
bucket的擁有者信息
bucket的ACL（AccessControlList）

請求語法

GET /?bucketInfo HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

響應元素(Response Elements)

名稱	描述
BucketInfo	保存Bucket信息內容的容器類型：容器子節點：Bucket節點父節點：無
Bucket	保存Bucket具體信息的容器類型：容器父節點：BucketInfo節點
CreationDate	Bucket創建時間。時間格式 2013-07-31T10:56:21.000Z 類型：時間父節點：BucketInfo.Bucket
ExtranetEndpoint	Bucket訪問的外網域名類型：字符串父節點：BucketInfo.Bucket
IntranetEndpoint	同區域ECS訪問Bucket的內網域名類型：字符串父節點：BucketInfo.Bucket
Location	Bucket所在數據中心的區域類型：字符串父節點：BucketInfo.Bucket
Name	Bucket名字類型：字符串父節點：BucketInfo.Bucket
Owner	用於存放Bucket擁有者信息的容器。類型：容器父節點：BucketInfo.Bucket
ID	Bucket擁有者的用戶ID。類型：字符串父節點：BucketInfo.Bucket.Owner
DisplayName	Bucket擁有者的名稱 (目前和ID一致)。類型：字符串父節點：BucketInfo.Bucket.Owner
AccessControlList	存儲ACL信息的容器類型：容器父節點：BucketInfo.Bucket
Grant	Bucket的ACL權限。類型：枚舉字符串有效值：private、public-read、public-read-write 父節點：BucketInfo.Bucket.AccessControlList

細節分析

如果Bucket不存在，返回404錯誤。錯誤碼：NoSuchBucket。
隻有Bucket的擁有者才能查看Bucket的信息，否則返回403 Forbidden錯誤,錯誤碼：AccessDenied。
請求可以從任何一個OSS的Endpoint發起。

示例

請求示例：

Get /?bucketInfo HTTP/1.1
Host: oss-example.oss.aliyuncs.com  
Date: Sat, 12 Sep 2015 07:51:28 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc: BuG4rRK+zNhH1AcF51NNHD39zXw=

成功獲取Bucket信息的返回示例：


HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906008B
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>
    <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>
    <Name>oss-example</Name>
    <Owner>
      <DisplayName>username</DisplayName>
      <ID>271834739143143</ID>
    </Owner>
    <AccessControlList>
      <Grant>private</Grant>
    </AccessControlList>
  </Bucket>
</BucketInfo>

獲取不存在的Bucket信息的返回示例：

HTTP/1.1 404 
x-oss-request-id: 534B371674E88A4D8906009B
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>568D547F31243C673BA14274</RequestId>
  <HostId>nosuchbucket.oss.aliyuncs.com</HostId>
  <BucketName>nosuchbucket</BucketName>
</Error>

獲取沒有權限訪問的Bucket信息的返回示例：

HTTP/1.1 403
x-oss-request-id: 534B371674E88A4D8906008C
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>568D5566F2D0F89F5C0EB66E</RequestId>
  <HostId>test.oss.aliyuncs.com</HostId>
</Error>

最後更新：2016-11-23 17:16:08

GetBucketInfo__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲

請求語法

響應元素(Response Elements)

細節分析

示例

上一篇： GetBucketLocation__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲

下一篇： GetBucketLogging__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲

相關內容

熱門內容

最新內容