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

Object Storage Service:ListBuckets (GetService)

最終更新日:Feb 23, 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はリクエスト元が所有するすべてのバケットを返します。

リソースグループの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

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

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

CreateDate

時間

2014-05-15T11:18:32.000Z

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

親ノード: ListAllMyBucketsResult.Buckets.Bucket

位置

String

oss-cn-hangzhou

バケットが配置されているリージョン。

親ノード: ListAllMyBucketsResult.Buckets.Bucket

ExtranetEndpoint

String

oss-cn-hangzhou.aliyuncs.com

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

親ノード: ListAllMyBucketsResult.Buckets.Bucket

IntranetEndpoint

String

oss-cn-hangzhou-internal.aliyuncs.com

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

親ノード: ListAllMyBucketsResult.Buckets.Bucket

Region

String

cn-hangzhou

バケットが配置されているリージョン。

親ノード: ListAllMyBucketsResult.Buckets.Bucket

StorageClass

String

標準

バケットのストレージクラス。 有効な値: StandardIAArchiveColdArchiveDeepColdArchive

親ノード: ListAllMyBucketsResult.Buckets.Bucket

ResourceGroupId

String

rg-aek27tc ********

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

親ノード: ListAllMyBucketsResult.Buckets.Bucket

  • 要求者が所有するすべてのバケットを照会する

    リクエストの例

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

    レスポンスの例

    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 nxj7dtwhcyl5hpvnhi:COS3OQkfQPnKmYZTEHYv2 **** 

    レスポンスの例

    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 nxj7dtlhcyl5hpvnhi:COS3OQkfQPnKmYZTEHYv2 ******
    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 nxj7dtlhcyl5hpvnhi:COS3OQkfQPnKmYZTEHYv2 ******
    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> 

OSS SDK

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

エラーコード

エラーコード

HTTPステータスコード

説明

AccessDenied

403

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