GetService (ListBuckets) を呼び出してバケットを一覧表示する - Object Storage Service

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

使用方法

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

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

リクエスト構文

GET / HTTP/1.1
Host: oss.example.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

ヘッダー

タイプ

必須

例

説明

x-oss-resource-group-id

文字列

いいえ

rg-aek27tc********

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

このヘッダーを含めてリクエストでリソースグループの ID を指定すると、OSS はそのリソースグループに属するすべてのバケットを返します。
リソースグループ ID が rg-default-id に設定されている場合、OSS はデフォルトのリソースグループに属するすべてのバケットを返します。
リクエストにこのヘッダーを含めてリソースグループ ID を指定しない場合、OSS はデフォルトのリソースグループに属するすべてのバケットを返します。
リクエストにこのヘッダーが含まれていない場合、OSS は Alibaba Cloud アカウントに属するすべてのバケットを返します。

リソースグループの ID は、[リソース管理] コンソールで取得するか、ListResourceGroups オペレーションを呼び出すことによって取得できます。詳細については、「リソースグループの基本情報を表示する」および「ListResourceGroups」をご参照ください。

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

リクエストパラメーター

ヘッダー	タイプ	必須	例	説明
prefix	文字列	いいえ	my	返すバケットの名前に含まれている必要があるプレフィックス。このパラメーターを指定しない場合、プレフィックスは返されるバケットのフィルタリングに使用されません。デフォルトでは、このパラメーターは空のままです。
marker	文字列	いいえ	mybucket10	ListBuckets (GetService) オペレーションが開始するバケットの名前。名前がマーカーパラメーターの値よりもアルファベット順で大きいバケットが返されます。このパラメーターを指定しない場合、すべてのバケットが返されます。デフォルトでは、このパラメーターは空のままです。
max-keys	整数	いいえ	10	リクエストに対して返すことができるバケットの最大数。有効な値: 1 ～ 1000 デフォルト値: 100

レスポンスヘッダー

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

レスポンス要素

説明

ListBuckets (GetService) オペレーションを呼び出すと、すべてのバケットが返される場合、レスポンスの XML 本文には Prefix、Marker、MaxKeys、IsTruncated、または NextMarker パラメーターは含まれません。

ヘッダー	タイプ	例	説明
ListAllMyBucketsResult	コンテナー	該当なし	ListBuckets (GetService) リクエストの結果を格納するコンテナー。子ノード: Owner と Buckets 親ノード: なし
Prefix	文字列	my	返されたバケットの名前に含まれるプレフィックス。親ノード: ListAllMyBucketsResult
Marker	文字列	mybucket	ListBuckets (GetService) オペレーションが開始するバケットの名前。親ノード: ListAllMyBucketsResult
MaxKeys	文字列	10	リクエストに対して返すことができるバケットの最大数。親ノード: ListAllMyBucketsResult
IsTruncated	列挙型文字列	true	すべての結果が返されるかどうかを示します。有効な値: true: リクエストに対して結果の一部のみが返されます。 false: リクエストに対してすべての結果が返されます。親ノード: ListAllMyBucketsResult
NextMarker	文字列	mybucket10	次の ListBuckets (GetService) リクエストのマーカー。残りの結果を返すために使用できます。親ノード: ListAllMyBucketsResult
Owner	コンテナー	該当なし	バケットオーナーに関する情報を格納するコンテナー。親ノード: ListAllMyBucketsResult
ID	文字列	ut_test_put_bucket	バケットオーナーのユーザー ID。親ノード: ListAllMyBucketsResult.Owner
DisplayName	文字列	ut_test_put_bucket	バケットオーナーの名前。バケットオーナーの名前はユーザー ID と同じです。親ノード: ListAllMyBucketsResult.Owner
Buckets	コンテナー	該当なし	複数のバケットに関する情報を格納するコンテナー。子ノード: Bucket 親ノード: ListAllMyBucketsResult
Bucket	コンテナー	該当なし	バケットに関する情報を格納するコンテナー。子ノード: Name、CreationDate、および Location 親ノード: ListAllMyBucketsResult.Buckets
Name	文字列	mybucket01	バケットの名前。親ノード: ListAllMyBucketsResult.Buckets.Bucket
CreationDate	時間	2014-05-15T11:18:32.000Z	バケットが作成された日時。形式: `yyyy-mm-ddThh:mm:ss.timezone`。親ノード: ListAllMyBucketsResult.Buckets.Bucket
Location	文字列	oss-cn-hangzhou	OSS リージョン ID。親ノード: ListAllMyBucketsResult.Buckets.Bucket
ExtranetEndpoint	文字列	oss-cn-hangzhou.aliyuncs.com	バケットのパブリックエンドポイント。親ノード: ListAllMyBucketsResult.Buckets.Bucket
IntranetEndpoint	文字列	oss-cn-hangzhou-internal.aliyuncs.com	バケットの内部エンドポイント。親ノード: ListAllMyBucketsResult.Buckets.Bucket
Region	文字列	cn-hangzhou	Alibaba Cloud リージョン ID。親ノード: ListAllMyBucketsResult.Buckets.Bucket
StorageClass	文字列	Standard	バケットのストレージクラス。有効な値: Standard、IA、Archive、ColdArchive、DeepColdArchive。親ノード: ListAllMyBucketsResult.Buckets.Bucket
ResourceGroupId	文字列	rg-aek27tc********	バケットが属するリソースグループの ID。バケットがデフォルトのリソースグループに属している場合、リソースグループ ID は rg-default-id です。親ノード: ListAllMyBucketsResult.Buckets.Bucket

例

Alibaba Cloud アカウントに属するすべてのバケットをクエリする

リクエストの例

GET / HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

成功レスポンスの例

HTTP/1.1 200 OK
Date: Thu, 15 May 2014 11:18:32 GMT
Content-Type: application/xml
Content-Length: 556
Connection: keep-alive
Server: 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>
      <Region>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>
      <Name>mybucket</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>IA</StorageClass>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

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

リクエストの例

GET /?prefix=my&max-keys=10 HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

成功レスポンスの例

HTTP/1.1 200 OK
Date: Thu, 15 May 2014 11:18:32 GMT
Content-Type: application/xml
Content-Length: 545
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300****
<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult>
  <Prefix>my</Prefix>
  <Marker>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>
      <Name>mybucket01</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>Standard</StorageClass>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

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

リクエスト例

GET / HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-resource-group-id: rg-aek27tc********

成功レスポンスの例

HTTP/1.1 200 OK
Date: Thu, 15 May 2014 11:18:32 GMT
Content-Type: application/xml
Content-Length: 556
Connection: keep-alive
Server: 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>
      <Name>test-bucket-1</Name>
      <Region>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>
      <Name>test-bucket-2</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>IA</StorageClass>
      <ResourceGroupId>rg-aek27tc********</ResourceGroupId>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

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

リクエスト例

GET / HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-resource-group-id: rg-default-id

成功レスポンスの例

HTTP/1.1 200 OK
Date: Thu, 15 May 2014 11:18:32 GMT
Content-Type: application/xml
Content-Length: 556
Connection: keep-alive
Server: 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>
      <Name>test-bucket-3</Name>
      <Region>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>
      <Name>test-bucket-4</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>IA</StorageClass>
      <ResourceGroupId>rg-default-id</ResourceGroupId>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

SDK

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

ossutil

ListBuckets 操作に対応する ossutil コマンドについては、「list-buckets (get-service)」をご参照ください。

エラーコード

エラーコード	HTTP ステータスコード	説明
AccessDenied	403	リクエストは匿名ユーザーからのもので、ユーザー認証情報が含まれていません。