バケットの情報を表示します。 バケットの情報を表示できるのは、バケットの所有者だけです。

GetBucketInfo リクエストは、任意の OSS エンドポイントから開始できます。

リクエスト構文

GET /?bucketInfo HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
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 Enumerated string

バケットの ACL。

有効な値:privatepublic-readpublic-read-write

親ノード:BucketInfo.Bucket.AccessControlList

DataRedundancyType Enumerated string

バケットのデータ冗長タイプ。

有効な値:LRSZRS

親ノード:BucketInfo.Bucket

StorageClass String

バケットのストレージクラス。

有効な値:StandardIAArchive

Comment String

バケットのコメント。

親ノード:BucketInfo.Bucket

Versioning String

バケットのバージョン管理機能のステータス。

有効な値:EnabledSuspended

親ノード:BucketInfo.Bucket

ServerSideEncryptionRule Container

サーバー側暗号化ルールを保存するコンテナー。

親ノード:BucketInfo.Bucket

ApplyServerSideEncryptionByDefault Container

デフォルトのサーバー側暗号化方式を保存するコンテナー。

親ノード:BucketInfo.Bucket

SSEAlgorithm String

デフォルトのサーバー側暗号化方式。

有効な値:KMS、AES256

KMSMasterKeyID String

現在の CMK ID。 SSEAlgorithm の値が KMS、かつ CMK ID が指定されている場合にのみ値が返されます。 それ以外の場合、この要素の値は null です。

リクエスト例

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

バケット情報の取得に成功した場合に返されるレスポンス例

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>
    <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>27183473914****</ID>
    </Owner>
    <AccessControlList>
      <Grant>private</Grant>
    </AccessControlList>
    <Comment>test</Comment>
  </Bucket>
</BucketInfo>

リクエストされたバケットが存在しない場合に返されるレスポンス例

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>
</Error>

リクエスト送信者がバケットのアクセス権限を持っていない場合に返されるレスポンス例

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

この API の SDK は次のとおりです。

エラーコード

エラーコード HTTP ステータスコード 説明
NoSuchBucket 404 ターゲットバケットは存在しません。
AccessDenied 403 バケット情報を表示する権限がありません。 バケットの情報を表示できるのは、バケットの所有者だけです。