すべてのプロダクト
Search

このプロダクト

    Object Storage Service:GetBucketInfo

    ドキュメントセンター

    Object Storage Service:GetBucketInfo

    最終更新日:Dec 03, 2024

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

    使用上の注意

    • Object Storage Service (OSS) エンドポイントからGetBucketInfoリクエストを開始できます。

    • デフォルトでは、Alibaba Cloudアカウントにはバケットに関する情報を照会する権限があります。 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

    コンテナー

    非該当

    バケットに関する情報を格納するコンテナー。

    子ノード: バケット

    親ノード: なし

    Bucket

    コンテナー

    非該当

    バケットに関する情報を格納するコンテナー。

    親ノード: BucketInfo

    CreationDate

    時間

    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

    場所

    String

    oss-cn-hangzhou

    OSSリージョンID。バケットが配置されているリージョンを指定します。

    親ノード: BucketInfo.Bucket

    StorageClass

    String

    標準

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

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

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

    名前

    String

    oss-example

    バケットの名前です。

    親ノード: BucketInfo.Bucket

    ResourceGroupId

    String

    rg-aek27tc ********

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

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

    親ノード: BucketInfo.Bucket

    所有者

    コンテナー

    非該当

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

    親ノード: BucketInfo.Bucket

    ID

    String

    27183473914 ****

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

    親ノード: BucketInfo.Bucket.Owner

    DisplayName

    String

    username

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

    親ノード: BucketInfo.Bucket.Owner

    AccessControlList

    コンテナー

    非該当

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

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

    親ノード: BucketInfo.Bucket

    助成金

    Enumerated string

    非公開

    バケットのACL。

    有効な値: private、public-read、public-read-write

    親ノード: BucketInfo.Bucket.AccessControlList

    DataRedundancyType

    Enumerated string

    LRS

    バケットの冗長タイプ。

    有効な値: LRSおよびZRS

    親ノード: BucketInfo.Bucket

    バージョン管理

    String

    Enabled

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

    有効な値: 有効および一時停止。

    詳細については、「PutBucketVersioning」をご参照ください。

    親ノード: BucketInfo.Bucket

    ServerSideEncryptionRule

    コンテナー

    非該当

    バケットのサーバー側暗号化方式を格納するコンテナー。

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

    親ノード: BucketInfo.Bucket

    SSEAlgorithm

    String

    KMS

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

    有効な値: KMSおよびAES256。

    親ノード: BucketInfo.Bucket.ServerSideEncryptionRule

    KMSMasterKeyID

    String

    ******

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

    親ノード: BucketInfo.Bucket.ServerSideEncryptionRule

    KMSDataEncryption

    String

    SM4

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

    親ノード: BucketInfo.Bucket.ServerSideEncryptionRule

    CrossRegionReplication

    String

    Disabled

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

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

    親ノード: BucketInfo.Bucket

    TransferAcceleration

    String

    Disabled

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

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

    親ノード: BucketInfo.Bucket

    HierarchicalNamespace

    String

    Enabled

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

    有効値: Enabled。

    親ノード: BucketInfo.Bucket

    AccessMonitor

    String

    Enabled

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

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

    親ノード: BucketInfo.Bucket

    BucketPolicy

    コンテナー

    非該当

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

    親ノード: BucketInfo.Bucket

    LogBucket

    String

    examplebucket

    ログを保存するバケットの名前。

    親ノード: BucketInfo.Bucket.BucketPolicy

    LogPrefix

    String

    ログ /

    ログが保存されるディレクトリ。

    親ノード: BucketInfo.Bucket.BucketPolicy

    BlockPublicAccess

    Boolean

    true

    バケットに対してブロックパブリックアクセスが有効になっているかどうかを示します。

    • true: ブロックパブリックアクセスが有効です。

    • false: ブロックパブリックアクセスは無効です。

    例

    リクエストの例 

    Get /?bucketInfo HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com  
Date: Sat, 12 Sep 2015 07:51:28 GMT
Authorization: OSS qn6q**************:77Dv****************

    レスポンスの例

    • バケットに関する情報が照会されたときのサンプル成功応答

      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

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

    エラーコード

    エラーコード

    HTTPステータスコード

    説明

    NoSuchBucket

    404

    ユーザーは存在しません。

    AccessDenied

    403

    バケットに関する情報を照会する権限がありません。 バケットに関する情報を照会できるのは、バケット所有者だけです。