すべてのプロダクト
Search

このプロダクト

    Object Storage Service:GetBucketInfo

    ドキュメントセンター

    Object Storage Service:GetBucketInfo

    最終更新日:Jun 20, 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

    リクエストヘッダー

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

    レスポンスヘッダー

    DescribeRegions要求に対する応答のすべてのヘッダーは、共通の応答ヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。

    レスポンス要素

    要素

    データ型

    例

    説明

    BucketInfo

    Container

    N/A

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

    子ノード: バケット

    親ノード: なし

    バケット

    Container

    N/A

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

    親ノード: 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

    所有者

    Container

    N/A

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

    親ノード: BucketInfo.Bucket

    ID

    String

    27183473914 ****

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

    親ノード: BucketInfo.Bucket.Owner

    DisplayName

    String

    username

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

    親ノード: BucketInfo.Bucket.Owner

    AccessControlList

    Container

    N/A

    バケットのアクセス制御リスト (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

    Container

    N/A

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

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

    親ノード: BucketInfo.Bucket

    ApplyServerSideEncryptionByDefault

    Container

    N/A

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

    親ノード: BucketInfo.Bucket

    SSEAlgorithm

    String

    KMS

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

    有効な値: KMSおよびAES256。

    親ノード: BucketInfo.Bucket

    KMSMasterKeyID

    String

    ******

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

    親ノード: BucketInfo.Bucket

    CrossRegionReplication

    String

    無効

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

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

    親ノード: BucketInfo.Bucket

    TransferAcceleration

    String

    無効

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

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

    親ノード: BucketInfo.Bucket

    HierarchicalNamespace

    String

    Enabled

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

    有効値: Enabled。

    親ノード: BucketInfo.Bucket

    AccessMonitor

    String

    Enabled

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

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

    親ノード: BucketInfo.Bucket

    BucketPolicy

    Container

    N/A

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

    親ノード: BucketInfo.Bucket

    LogBucket

    String

    examplebucket

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

    LogPrefix

    String

    ログ /

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

    BlockPublicAccess

    Boolean

    true

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

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

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

    例

    リクエストの例 

    Get /?bucketInfo HTTP/1.1
ホスト: examplebucket.oss-cn-hangzhou.aliyuncs.com
日付: 9月12日土曜日2015 07:51:28 GMT
承認: OSS qn6q ****************: 77Dv **************************

    レスポンスの例

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

      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>
  <EC>0015-00000101</EC>
</エラー>

    • バケットにアクセスする権限がない場合のサンプルエラー応答 

      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ステータスコード

    説明

    NoSuchBucket

    404

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

    AccessDenied

    403

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