すべてのプロダクト
Search

このプロダクト

    Object Storage Service:ListBuckets (GetService)

    ドキュメントセンター

    Object Storage Service:ListBuckets (GetService)

    最終更新日:Jun 20, 2024

    Alibaba Cloudアカウントに属するすべてのバケットを一覧表示します。 プレフィックス、マーカー、またはmax-keysパラメーターを指定して、特定の条件を満たすバケットを一覧表示できます。

    使用上の注意

    Object Storage Service (OSS) バケットを一覧表示するには、oss:ListBuckets権限が必要です。

    詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

    リクエスト構文

    GET / HTTP/1.1
ホスト: oss.example.com
日付: GMT日付
権限付与: SignatureValue

    リクエストヘッダー

    ヘッダー

    データ型

    必須

    例

    説明

    x-oss-resource-group-id

    String

    任意

    rg-aek27tc ********

    リソースグループの ID です。

    • このヘッダーを含め、リクエストにリソースグループのIDを指定すると、リソースグループに属するすべてのバケットが返されます。

      リソースグループIDがrg-default-idに設定されている場合、OSSはデフォルトリソースグループに属するすべてのバケットを返します。

    • リクエストにこのヘッダーを含めたが、リクエストにリソースグループIDを指定しない場合、OSSはデフォルトリソースグループに属するすべてのバケットを返します。

    • このヘッダーがリクエストに含まれていない場合、OSSはAlibaba Cloudアカウントに属するすべてのバケットを返します。

    リソースグループのIDは、resource Managementコンソールで取得するか、ListResourceGroups操作を呼び出して取得できます。 詳細については、「リソースグループに関する基本情報の表示」および「ListResourceGroups」をご参照ください。

    ListBuckets (GetService) リクエストに含まれるその他の一般的なリクエストヘッダー (HostやDateなど) の詳細については、「一般的なリクエストヘッダー」をご参照ください。

    リクエストパラメーター

    ヘッダー

    データ型

    必須

    例

    説明

    prefix

    String

    任意

    my

    返すバケットの名前に含める必要があるプレフィックス。 このパラメーターが指定されていない場合、プレフィックスは返されたバケットのフィルタリングに使用されません。

    デフォルトでは、このパラメータは空のままです。

    marker

    String

    任意

    mybucket10

    ListBuckets (GetService) 操作が開始されるバケットの名前。 名前がmarkerパラメーターの値よりもアルファベット順に大きいバケットが返されます。 このパラメーターが指定されていない場合、すべてのバケットが返されます。

    デフォルトでは、このパラメータは空のままです。

    max-keys

    Integer

    任意

    10

    リクエストに対して返すことができるバケットの最大数。

    有効な値: 1 ~ 1000

    デフォルト値：100

    レスポンスヘッダー

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

    レスポンス要素

    説明

    ListBuckets (GetService) 操作を呼び出すと、すべてのバケットが返された場合、応答のXML本文にPrefix、Marker、MaxKeys、IsTruncated、またはNextMarkerパラメーターは含まれません。

    ヘッダー

    データ型

    例

    説明

    ListAllMyBucketsResult

    Container

    N/A

    ListBuckets (GetService) リクエストの結果を格納するコンテナー。

    子ノード: 所有者とバケット

    親ノード: なし

    接頭辞

    String

    my

    返されたバケットの名前に含まれるプレフィックス。

    親ノード: ListAllMyBucketsResult

    Marker

    String

    mybucket

    ListBuckets (GetService) 操作が開始されるバケットの名前。

    親ノード: ListAllMyBucketsResult

    MaxKeys

    String

    10

    リクエストに対して返すことができるバケットの最大数。

    親ノード: ListAllMyBucketsResult

    IsTruncated

    Enumerated string

    true

    すべての結果が返されているかどうかを示します。 有効な値：

    • true: リクエストの結果の一部のみが返されます。

    • false: リクエストに対してすべての結果が返されます。

    親ノード: ListAllMyBucketsResult

    NextMarker

    String

    mybucket10

    次のListBuckets (GetService) リクエストのマーカー。残りの結果を返すために使用できます。

    親ノード: ListAllMyBucketsResult

    Owner

    Container

    N/A

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

    親ノード: ListAllMyBucketsResult

    ID

    String

    ut_test_put_bucket

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

    親ノード: ListAllMyBucketsResult.Owner

    DisplayName

    String

    ut_test_put_bucket

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

    親ノード: ListAllMyBucketsResult.Owner

    バケット

    Container

    N/A

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

    子ノード: バケット

    親ノード: ListAllMyBucketsResult

    バケット

    Container

    N/A

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

    子ノード: Name、CreationDate、およびLocation

    親ノード: ListAllMyBucketsResult.Buckets

    名前

    String

    mybucket01

    バケットの名前です。

    親ノード: ListAllMyBucketsResult.Buckets.Bucket

    CreationDate

    時間

    2014-05-15T11:18:32.000Z

    バケットが作成された時刻。 形式: yyyy-mm-ddThh:mm:ss.timezone

    親ノード: ListAllMyBucketsResult.Buckets.Bucket

    位置

    String

    oss-cn-hangzhou

    OSSリージョンID。

    親ノード: ListAllMyBucketsResult.Buckets.Bucket

    ExtranetEndpoint

    String

    oss-cn-hangzhou.aliyuncs.com

    バケットのパブリックエンドポイント。

    親ノード: ListAllMyBucketsResult.Buckets.Bucket

    IntranetEndpoint

    String

    oss-cn-hangzhou-internal.aliyuncs.com

    バケットの内部エンドポイント。

    親ノード: ListAllMyBucketsResult.Buckets.Bucket

    Region

    String

    cn-hangzhou

    Alibaba CloudリージョンID。

    親ノード: ListAllMyBucketsResult.Buckets.Bucket

    StorageClass

    String

    標準

    バケットのストレージクラス。 有効な値: Standard、IA、Archive、ColdArchive、DeepColdArchive

    親ノード: ListAllMyBucketsResult.Buckets.Bucket

    ResourceGroupId

    String

    rg-aek27tc ********

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

    親ノード: ListAllMyBucketsResult.Buckets.Bucket

    例

    • Alibaba Cloudアカウントに属するすべてのバケットを照会する

      リクエストの例

      GET / HTTP/1.1
日付: 5月15日木曜日11:18:32 GMT 2014
ホスト: oss-cn-hangzhou.aliyuncs.com
承認: OSS qn6q ****************: 77Dv **************************

      正常に処理された場合のレスポンス例 

      HTTP/1.1 200 OK
日付: 5月15日木曜日11:18:32 GMT 2014
Content-Type: application/xml
コンテンツ-長さ: 556
接続: キープアライブ
サーバー: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300 ****
<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
  <Owner>
    <ID>512 **</ID>
    <DisplayName>51264</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <CreationDate>2014-02-17T18:12:43.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-shanghai.aliyuncs.com</ExtranetEndpoint>
      <IntranetEndpoint>oss-cn-shanghai-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-shanghai</Location>
      <Name>app-base-oss</Name>
      <リージョン> cn-shanghai</Region>
      <StorageClass>Standard</StorageClass>
    </Bucket>
    <Bucket>
      <CreationDate>2014-02-25T11:21:04.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint>
      <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-hangzhou</Location>
      <名前> mybucket</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>IA</StorageClass>
    </Bucket>
  </バケット>
</ListAllMyBucketsResult>

    • プレフィックスと返されるバケットの最大数を指定してバケットを照会する

      リクエストの例

      GET /?prefix=my&max-keys=10 HTTP/1.1
日付: 5月15日木曜日11:18:32 GMT 2014
ホスト: oss-cn-hangzhou.aliyuncs.com
承認: OSS qn6q ****************: 77Dv **************************

      正常に処理された場合のレスポンス例 

      HTTP/1.1 200 OK
日付: 5月15日木曜日11:18:32 GMT 2014
Content-Type: application/xml
コンテンツ-長さ: 545
接続: キープアライブ
サーバー: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300 ****
<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
  <Prefix>my</Prefix>
  <マーカー> mybucket</Marker>
  <MaxKeys>10</MaxKeys>
  <IsTruncated>true</IsTruncated>
  <NextMarker>mybucket10</NextMarker>
  <Owner>
    <ID>ut_test_put_bucket</ID>
    <DisplayName>ut_test_put_bucket</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <CreationDate>2014-05-14T11:18:32.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint>
      <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-hangzhou</Location>
      <名前> mybucket01</名前>
      <Region>cn-hangzhou</Region>
      <StorageClass>Standard</StorageClass>
    </Bucket>
  </バケット>
</ListAllMyBucketsResult>

    • 特定のリソースグループに属するすべてのバケットを照会する

      リクエストの例

      GET / HTTP/1.1
日付: 5月15日木曜日11:18:32 GMT 2014
ホスト: oss-cn-hangzhou.aliyuncs.com
承認: OSS qn6q ****************: 77Dv **************************
x-oss-resource-group-id: rg-aek27tc ********

      正常に処理された場合のレスポンス例

      HTTP/1.1 200 OK
日付: 5月15日木曜日11:18:32 GMT 2014
Content-Type: application/xml
コンテンツ-長さ: 556
接続: キープアライブ
サーバー: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300 ****
<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
  <Owner>
    <ID>512 **</ID>
    <DisplayName>51264</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <CreationDate>2014-02-07T18:12:43.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-shanghai.aliyuncs.com</ExtranetEndpoint>
      <IntranetEndpoint>oss-cn-shanghai-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-shanghai</Location>
      <名前> test-bucket-1</Name>
      <リージョン> cn-shanghai</Region>
      <StorageClass>Standard</StorageClass>
      <ResourceGroupId>rg-aek27tc ********</ResourceGroupId>
    </Bucket>
    <Bucket>
      <CreationDate>2014-02-05T11:21:04.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint>
      <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-hangzhou</Location>
      <名前> test-bucket-2</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>IA</StorageClass>
      <ResourceGroupId>rg-aek27tc ********</ResourceGroupId>
    </Bucket>
  </バケット>
</ListAllMyBucketsResult>

    • デフォルトリソースグループ内のすべてのバケットを照会する

      リクエストの例

      GET / HTTP/1.1
日付: 5月15日木曜日11:18:32 GMT 2014
ホスト: oss-cn-hangzhou.aliyuncs.com
承認: OSS qn6q ****************: 77Dv **************************
x-oss-resource-group-id: rg-default-id

      正常に処理された場合のレスポンス例

      HTTP/1.1 200 OK
日付: 5月15日木曜日11:18:32 GMT 2014
Content-Type: application/xml
コンテンツ-長さ: 556
接続: キープアライブ
サーバー: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300 ****
<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
  <Owner>
    <ID>512 **</ID>
    <DisplayName>51264</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <CreationDate>2014-02-07T18:12:43.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-shanghai.aliyuncs.com</ExtranetEndpoint>
      <IntranetEndpoint>oss-cn-shanghai-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-shanghai</Location>
      <名前> test-bucket-3</Name>
      <リージョン> cn-shanghai</Region>
      <StorageClass>Standard</StorageClass>
      <ResourceGroupId>rg-default-id</ResourceGroupId>
    </Bucket>
    <Bucket>
      <CreationDate>2014-02-05T11:21:04.000Z</CreationDate>
      <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint>
      <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>
      <Location>oss-cn-hangzhou</Location>
      <名前> test-bucket-4</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>IA</StorageClass>
      <ResourceGroupId>rg-default-id</ResourceGroupId>
    </Bucket>
  </バケット>
</ListAllMyBucketsResult>

    SDK

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

    エラーコード

    エラーコード

    HTTPステータスコード

    説明

    AccessDenied

    403

    リクエストは匿名ユーザーからのもので、ユーザー認証情報は含まれません。