すべてのプロダクト
Search

このプロダクト

    Object Storage Service:GetBucketInfo

    ドキュメントセンター

    Object Storage Service:GetBucketInfo

    最終更新日:Dec 07, 2025

    GetBucketInfo 操作を呼び出して、バケットに関する情報を表示します。

    注意事項

    • このリクエストは、任意の Object Storage Service (OSS) エンドポイントから送信できます。

    • デフォルトでは、Alibaba Cloud アカウントはバケット情報を表示する権限を持っています。 Resource Access Management (RAM) ユーザーまたは Security Token Service (STS) を使用してバケット情報を表示するには、oss:GetBucketInfo 権限が必要です。 詳細については、「RAM ユーザーへのカスタムポリシーのアタッチ」をご参照ください。

    リクエスト構文

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

    リクエストヘッダー

    DescribeRegions リクエストのすべてのヘッダーは、共通リクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。

    レスポンスヘッダー

    DescribeRegions リクエストへのレスポンス内のすべてのヘッダーは、共通レスポンスヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。

    レスポンス要素

    名前

    型

    例

    説明

    BucketInfo

    コンテナー

    N/A

    バケット情報のコンテナーです。

    子ノード：Bucket

    親ノード：なし

    Bucket

    コンテナー

    N/A

    バケット情報のコンテナーです。

    親ノード：BucketInfo

    CreationDate

    Time

    2013-07-31T10:56:21.000Z

    バケットが作成された時刻です。 時刻は UTC です。

    親ノード：BucketInfo.Bucket

    ExtranetEndpoint

    String

    oss-cn-hangzhou.aliyuncs.com

    パブリックエンドポイントです。

    親ノード：BucketInfo.Bucket

    IntranetEndpoint

    String

    oss-cn-hangzhou-internal.aliyuncs.com

    内部エンドポイントです。

    親ノード：BucketInfo.Bucket

    Location

    String

    oss-cn-hangzhou

    バケットが配置されているリージョンです。 この値は OSS のリージョン ID です。

    親ノード：BucketInfo.Bucket

    StorageClass

    String

    Standard

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

    有効な値：Standard、IA、Archive、ColdArchive。

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

    Name

    String

    oss-example

    バケットの名前です。

    親ノード：BucketInfo.Bucket

    ResourceGroupId

    String

    rg-aek27tc********

    バケットが属するリソースグループの ID です。

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

    親ノード：BucketInfo.Bucket

    Owner

    コンテナー

    N/A

    バケットオーナーに関する情報のコンテナーです。

    親ノード：BucketInfo.Bucket

    ID

    String

    27183473914****

    バケットオーナーのユーザー ID です。

    親ノード：BucketInfo.Bucket.Owner

    DisplayName

    String

    username

    バケットオーナーの名前です。 このパラメーターの値は ID と同じです。

    親ノード：BucketInfo.Bucket.Owner

    AccessControlList

    コンテナー

    N/A

    バケットのアクセス制御リスト (ACL) のコンテナーです。

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

    親ノード：BucketInfo.Bucket

    Grant

    Enumeration

    private

    バケットの ACL です。

    有効な値：private、public-read、public-read-write。

    親ノード：BucketInfo.Bucket.AccessControlList

    DataRedundancyType

    Enumeration

    LRS

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

    有効な値：LRS、ZRS。

    親ノード：BucketInfo.Bucket

    Versioning

    String

    Enabled

    バケットのバージョン管理状態です。

    有効な値：Enabled、Suspended。

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

    親ノード：BucketInfo.Bucket

    ServerSideEncryptionRule

    コンテナー

    N/A

    サーバー側暗号化ルールのコンテナーです。

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

    親ノード：BucketInfo.Bucket

    SSEAlgorithm

    String

    KMS

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

    有効な値：KMS、AES256。

    親ノード：BucketInfo.Bucket.ServerSideEncryptionRule

    KMSMasterKeyID

    String

    ******

    使用中の KMS キーの ID です。 このパラメーターは、`SSEAlgorithm` が `KMS` に設定され、キー ID が指定されている場合にのみ返されます。 それ以外の場合、このパラメーターは空です。

    親ノード：BucketInfo.Bucket.ServerSideEncryptionRule

    KMSDataEncryption

    String

    SM4

    オブジェクトの暗号化アルゴリズムです。 このパラメーターが指定されていない場合、AES-256 が使用されます。 このパラメーターは、`SSEAlgorithm` が `KMS` に設定されている場合にのみ有効です。

    親ノード：BucketInfo.Bucket.ServerSideEncryptionRule

    CrossRegionReplication

    String

    Disabled

    バケットのクロスリージョンレプリケーション (CRR) の状態です。

    有効な値：Enabled、Disabled。

    親ノード：BucketInfo.Bucket

    TransferAcceleration

    String

    Disabled

    バケットの転送アクセラレーションの状態です。

    有効な値：Enabled、Disabled。

    親ノード：BucketInfo.Bucket

    HierarchicalNamespace

    String

    Enabled

    バケットの階層型名前空間の状態です。

    有効な値：Enabled。

    親ノード：BucketInfo.Bucket

    AccessMonitor

    String

    Enabled

    バケットのアクセス追跡の状態です。

    有効な値：Enabled、Disabled。

    親ノード：BucketInfo.Bucket

    BucketPolicy

    コンテナー

    N/A

    ログ情報のコンテナーです。

    親ノード：BucketInfo.Bucket

    LogBucket

    String

    examplebucket

    ログレコードを格納するバケットの名前です。

    親ノード：BucketInfo.Bucket.BucketPolicy

    LogPrefix

    String

    log/

    ログファイルが格納されているディレクトリです。

    親ノード：BucketInfo.Bucket.BucketPolicy

    BlockPublicAccess

    ブール値

    true

    バケットの Block Public Access の構成です。

    • true：Block Public Access は有効です。

    • false：Block Public Access は無効です。

    例

    リクエストの例

    Get /?bucketInfo HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com  
Date: Thu, 17 Apr 2025 07:51:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    レスポンスの例

    • 成功レスポンスの例

      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>
    <StorageClass>Standard</StorageClass>
    <TransferAcceleration>Disabled</TransferAcceleration>
    <CrossRegionReplication>Disabled</CrossRegionReplication>
    <HierarchicalNamespace>Enabled</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>log/</LogPrefix>
    </BucketPolicy>
  </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>
  <EC>0015-00000101</EC>
</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

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

    ossutil コマンドラインツール

    この操作に対応する ossutil コマンドの詳細については、「get-bucket-info」をご参照ください。

    エラーコード

    エラーコード

    HTTP ステータスコード

    説明

    NoSuchBucket

    404

    指定されたバケットは存在しません。

    AccessDenied

    403

    バケット情報を表示する権限がありません。 バケットオーナーのみがバケット情報を表示できます。