edit-icon download-icon

GetBucketInfo

最終更新日: Aug 01, 2018

GetBucketInfo アクションはバケット情報を表示することができます。 バケット情報には次のものが含まれます。

  • 作成時間
  • インターネットアクセスエンドポイント
  • イントラネットアクセスエンドポイント
  • バケット所有者情報
  • バケットACL(AccessControlList)

リクエスト構文

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

レスポンス 要素

名前 説明
BucketInfo container バケット情報の内容を保存するコンテナ
サブノード:Bucket ノード
親ノード:なし
Bucket container バケット固有情報を保存するコンテナ
親ノード:BucketInfoノード
CreationDate time バケットの作成時間。時間形式:2013-07-31T10:56:21.000Z
親ノード:BucketInfo.Bucket
ExtranetEndpoint string バケットにアクセスするインターネットドメイン名
親ノード:BucketInfo.Bucket
IntranetEndpoint string 同じリージョン内のECSからバケットにアクセスするためのイントラネットドメイン名
親ノード:BucketInfo.Bucket
Location string バケットが配置されているデータセンターのリージョン
親ノード:BucketInfo.Bucket
Name string バケット名
親ノード:BucketInfo.Bucket
Owner container バケット所有者に関する情報を保存するコンテナ
親ノード:BucketInfo.Bucket
ID string バケット所有者のユーザーID
親ノード:BucketInfo.Bucket.Owner
DisplayName string バケット所有者の名前(現在はIDと同じ)
親ノード:BucketInfo.Bucket.Owner
AccessControlList container ACL 情報を格納するコンテナ
親ノード:BucketInfo.Bucket
Grant string バケットのACL権限
有効な値:private、public-read、public-read-write
親ノード:BucketInfo.Bucket.AccessControlList

詳細分析

  • バケットが存在しない場合、エラー 404 が返されます。 エラーコード:NoSuchBucket。
  • バケットの所有者だけがバケットの情報を見ることができます。 他のユーザーがバケット情報へアクセスしようとするとエラー 403 が返されます。 エラーコード:AccessDenied。
  • リクエストは任意のOSSエンドポイントから開始できます。

リクエストの例:

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

リターンの例:(バケット情報が正常に取得される場合)

  1. HTTP/1.1 200
  2. x-oss-request-id: 534B371674E88A4D8906008B
  3. Date: Sat, 12 Sep 2015 07:51:28 GMT
  4. Connection: keep-alive
  5. Content-Length: 531
  6. Server: AliyunOSS
  7. <?xml version="1.0" encoding="UTF-8"?>
  8. <BucketInfo>
  9. <Bucket>
  10. <CreationDate>2013-07-31T10:56:21.000Z</CreationDate>
  11. <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint>
  12. <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>
  13. <Location>oss-cn-hangzhou</Location>
  14. <Name>oss-example</Name>
  15. <Owner>
  16. <DisplayName>username</DisplayName>
  17. <ID>271834739143143</ID>
  18. </Owner>
  19. <AccessControlList>
  20. <Grant>private</Grant>
  21. </AccessControlList>
  22. </Bucket>
  23. </BucketInfo>

リターンの例:(バケット情報は存在しない場合)

  1. HTTP/1.1 404
  2. x-oss-request-id: 534B371674E88A4D8906009B
  3. Date: Sat, 12 Sep 2015 07:51:28 GMT
  4. Connection: keep-alive
  5. Content-Length: 308
  6. Server: AliyunOSS
  7. <?xml version="1.0" encoding="UTF-8"?>
  8. <Error>
  9. <Code>NoSuchBucket</Code>
  10. <Message>The specified bucket does not exist.</Message>
  11. <RequestId>568D547F31243C673BA14274</RequestId>
  12. <HostId>nosuchbucket.oss.aliyuncs.com</HostId>
  13. <BucketName>nosuchbucket</BucketName>
  14. </Error>

リターンの例:(バケット情報へのアクセス権限がない場合)

  1. HTTP/1.1 403
  2. x-oss-request-id: 534B371674E88A4D8906008C
  3. Date: Sat, 12 Sep 2015 07:51:28 GMT
  4. Connection: keep-alive
  5. Content-Length: 209
  6. Server: AliyunOSS
  7. <?xml version="1.0" encoding="UTF-8"?>
  8. <Error>
  9. <Code>AccessDenied</Code>
  10. <Message>AccessDenied</Message>
  11. <RequestId>568D5566F2D0F89F5C0EB66E</RequestId>
  12. <HostId>test.oss.aliyuncs.com</HostId>
  13. </Error>