すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:GetBucketInfo

最終更新日:Feb 23, 2024

バケットに関する情報をクエリします。

使用上の注意

  • 任意のObject Storage Service (OSS) エンドポイントからGetBucketInfoリクエストを開始できます。
  • デフォルトでは、Alibaba Cloudアカウントにはバケットに関する情報を照会する権限があります。 RAMユーザーまたはSecurity Token Service (STS) を使用してバケットに関する情報を照会するには、oss:GetBucketInfo権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

リクエスト構文

GET /?bucketInfo HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue 

リクエストヘッダー

このリクエストには、共通リクエストヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。

レスポンスヘッダー

このリクエストには、共通のレスポンスヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。

レスポンス要素

要素データ型説明
BucketInfoContainerN/Aバケット情報を格納するコンテナー。

子ノード: バケット

親ノード: なし

BucketContainerN/Aバケット情報を格納するコンテナー。

親ノード: BucketInfo

CreationDate時間2013-07-31T10:56:21.000Zバケットが作成された時刻。 時刻は UTC です。

親ノード: BucketInfo.Bucket

ExtranetEndpointStringoss-cn-hangzhou.aliyuncs.comインターネット経由でバケットにアクセスするために使用されるパブリックエンドポイント。

親ノード: BucketInfo.Bucket

IntranetEndpointStringoss-cn-hangzhou-internal.aliyuncs.comバケットと同じリージョンにあるECS (Elastic Compute Service) インスタンスからバケットにアクセスするために使用される内部エンドポイント。

親ノード: BucketInfo.Bucket

場所Stringoss-cn-hangzhouバケットが配置されているリージョン。

親ノード: BucketInfo.Bucket

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

有効な値: StandardIAArchiveColdArchive

ストレージクラスの詳細については、「概要」をご参照ください。

名前Stringoss-exampleバケットの名前です。

親ノード: BucketInfo.Bucket

ResourceGroupIdStringrg-aek27tc ********バケットが属するリソースグループのID。

バケットがデフォルトリソースグループに属している場合、リソースグループIDはrg-default-idです。

親ノード: BucketInfo.Bucket

所有者ContainerN/Aバケット所有者に関する情報を格納するコンテナー。

親ノード: BucketInfo.Bucket

IDString27183473914 ****バケット所有者のユーザーID。

親ノード: BucketInfo.Bucket.Owner

DisplayNameStringusernameバケット所有者の名前。バケット所有者のユーザーIDと同じです。

親ノード: BucketInfo.Bucket.Owner

AccessControlListContainerN/Aバケットに関するアクセス制御リスト (ACL) 情報を格納するコンテナー。

バケットACLの詳細については、「バケットACL」をご参照ください。

親ノード: BucketInfo.Bucket

助成金Enumerated string非公開バケットのACL。

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

親ノード: BucketInfo.Bucket.AccessControlList

DataRedundancyTypeEnumerated stringLRSバケットのディザスタリカバリタイプ。

有効な値:LRSZRS

親ノード: BucketInfo.Bucket

バージョン管理StringEnabledバケットのバージョン管理が有効かどうかを示します。

有効な値: EnabledおよびSuspended

バージョン管理の詳細については、「PutBucketVersioning」をご参照ください。

親ノード: BucketInfo.Bucket

ServerSideEncryptionRuleContainerN/Aサーバー側の暗号化方式を格納するコンテナー。

サーバー側の暗号化の詳細については、「サーバー側の暗号化」をご参照ください。

親ノード: BucketInfo.Bucket

ApplyServerSideEncryptionByDefaultContainerN/Aデフォルトで使用されるサーバー側の暗号化方法を格納するコンテナー。

親ノード: BucketInfo.Bucket

SSEAlgorithmStringKMSデフォルトで使用されるサーバー側の暗号化方法。

有効な値: KMSおよびAES256

親ノード: BucketInfo.Bucket

KMSMasterKeyIDString******使用中の顧客マスターキー (CMK) ID。 SSEAlgorithmをKMSに設定し、CMK IDを指定した場合にのみ、有効な値が返されます。 それ以外の場合は、空の値が返されます。

親ノード: BucketInfo.Bucket

CrossRegionReplicationString無効バケットに対してクロスリージョンレプリケーション (CRR) が有効になっているかどうかを示します。

有効な値: 有効および無効

親ノード: BucketInfo.Bucket

TransferAccelerationString無効バケットの転送アクセラレーションが有効になっているかどうかを示します。

有効な値: 有効および無効

親ノード: BucketInfo.Bucket

HierarchicalNamespaceStringEnabledバケットの階層名前空間が有効かどうかを示します。

有効値: Enabled

親ノード: BucketInfo.Bucket

AccessMonitorStringEnabledバケットのアクセス追跡が有効かどうかを示します。

有効な値: 有効および無効

親ノード: BucketInfo.Bucket

BucketPolicyContainerN/Aログを保存するコンテナー。

親ノード: BucketInfo.Bucket

LogBucketStringexamplebucketログを保存するバケットの名前。
LogPrefixStringログ /ログが保存されるディレクトリ。

リクエストの例

Get /?bucketInfo HTTP/1.1
ホスト: examplebucket.oss-cn-hangzhou.aliyuncs.com
日付: 9月12日土曜日2015 07:51:28 GMT
承認: OSS qn6qrrqxo2oawuk53otf ****: BuG4rRK + zNhH1AcF51NNHD39 **** 
レスポンスの例
  • <x id="1" type="exclude" text="codeblock id=&quot;codeblock_vow_acp_88d&quot; props=&quot;china&quot;>HTTP/1.1 200x-oss-request-id: 534B371674E88A4D8906 *** サーバー日付: Sat、OSS: 531-Aliyt: 19 /6接続: 10G28-ファイル: 2015 *6; サーバーの長xml version=&quot;1.0&quot; エンコード=&quot;UTF-8&quot ?& gt;<BucketInfo>< バケット><AccessMonitor> 有効</AccessMonitor><<CreationDate>2013-07-31T10:56:21.000Z extranetEndpoint</ExtranetEndpoint><IntranetEndpoint&g t;oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>< 加速; ロケーション>oss-cn-hangzhou<<CrossRegionReplication> 無効化された</CrossRegionReplication>< 名前>oss-example</Name><ResourceGroupId>rg-aek27tc ***g***< Dist; 所有者の名前&ID>27183473914 ****</ID></所有者><AccessControlList>< グラント> プライベート< logBucket>examplebucket</LogBucket><LogPrefix>log/</LogPrefix></BucketPolicy></バケット></BucketInfo></codeblock"/>
    HTTP/1.1 200
    x-oss-request-id: 534B371674E88A4D8906 ****
    日付: 9月12日土曜日2015 07:51:28 GMT
    接続: キープアライブ
    コンテンツ-長さ: 531
    サーバー: 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>
        <StorageClass>Standard</StorageClass>
        <TransferAcceleration> 無効 </TransferAcceleration>
        <CrossRegionReplication> 無効 </CrossRegionReplication>
        <HierarchicalNamespace> 有効 </HierarchicalNamespace>
        <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> ログ /</LogPrefix>
        </BucketPolicy>
      </バケット>
    </BucketInfo> 
  • 指定されたバケットが存在し
    ない場合のサンプルエラー応答HTTP/1.1 404
    x-oss-request-id: 534B371674E88A4D8906 ****
    日付: 9月12日土曜日2015 07:51:28 GMT
    接続: キープアライブ
    コンテンツ-長さ: 308
    サーバー: AliyunOSS
    <?xml version="1.0" encoding="UTF-8"?>
    <エラー>
      <Code>NoSuchBucket</Code>
      <Message> 指定されたバケットは存在しません。</Message>
      <RequestId>568D547F31243C673BA1****</RequestId>
      <HostId>nosuchbucket.oss.aliyuncs.com</HostId>
      <BucketName>nosuchbucket</BucketName>
    </エラー> 
  • バケット
    のHTTP/1.1 403にアクセスする権限がない場合のサンプルエラー応答
    x-oss-request-id: 534B371674E88A4D8906 ****
    日付: 9月12日土曜日2015 07:51:28 GMT
    接続: キープアライブ
    コンテンツ-長さ: 209
    サーバー: AliyunOSS
    <?xml version="1.0" encoding="UTF-8"?>
    <エラー>
      <Code>AccessDenied</Code>
      <Message>AccessDenied</Message>
      <RequestId>568D5566F2D0F89F5C0E****</RequestId>
      <HostI d>test.oss.aliyuncs.com</HostId>
    </エラー> 

SDK

次のプログラミング言語のOSS SDKを使用して、GetBucketInfo操作を呼び出すことができます。

エラーコード

エラーコードHTTPステータスコード説明
NoSuchBucket404バケットが存在しない場合に返されるエラーメッセージ。
AccessDenied403バケットに関する情報を照会する権限がない場合に返されるエラーメッセージ。 バケットに関する情報を照会できるのは、バケット所有者だけです。