ListResourcePoolBuckets - Object Storage Service - Alibaba Cloud ドキュメントセンター

ListResourcePoolBuckets 操作を使用して、指定されたリソースプール内のバケットのリストを取得します。

注意事項

リソースプール QoS は招待プレビュー中です。リージョン内の OSS バケットのスループットが 500 Gbit/s に達した場合、または 500 Gbit/s を超えた場合は、テクニカルサポートに連絡して、この機能を申請できます。
デフォルトでは、Alibaba Cloud アカウントには、指定されたリソースプール内のバケットのリストを取得する権限があります。 RAM ユーザーまたは Security Token Service を介してこのリストにアクセスするには、oss:ListResourcePoolBuckets 権限が必要です。詳細な手順については、「RAM ポリシーの一般的な例」をご参照ください。

リクエスト構文

GET /?resourcePoolBuckets&resourcePool=ResourcePoolName&max-keys=2&continuation-token=abc
Host: oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

この操作では、共通のリクエストヘッダーのみを使用します。詳細については、「共通リクエストヘッダー」をご参照ください。

リクエスト要素

名前	タイプ	必須	値の例	説明
resourcePool	文字列	はい	resource-pool-for-ai	リソースプールの名前。
max-keys	整数	いいえ	10	このリクエストで返すバケットの最大数。
continuation-token	文字列	いいえ	rp-bucket-01	情報を返し始めるバケット。

レスポンスヘッダー

この操作では、共通のレスポンスヘッダーのみを使用します。詳細については、「共通レスポンスヘッダー」をご参照ください。

レスポンス要素

名前	タイプ	値の例	説明
ListResourcePoolBucketsResult	コンテナー	該当なし	リクエストの結果を格納するコンテナー。親ノード: なし
ContinuationToken	文字列	abcd	この ListResourcePoolBuckets リクエストで使用される continuationToken。親ノード: ListResourcePoolBucketsResult
NextContinuationToken	文字列	xyz	この ListResourcePoolBuckets リクエストに後続の結果が含まれていることを示します。 NextContinuationToken の値は、後続の結果をクエリするために ContinuationToken の値として使用されます。親ノード: ListResourcePoolBucketsResult
IsTruncated	ブール値	true	クエリされた結果が切り捨てられるかどうかを示します。 true は、今回はすべての結果が返されないことを示します。 false は、今回はすべての結果が返されることを示します。親ノード: ListResourcePoolBucketsResult
ResourcePoolBucket	コンテナー	該当なし	リソースプール内のバケットリストの結果を格納するコンテナー。親ノード: ListResourcePoolBucketsResult
Name	文字列	rp-bucket-01	バケットの名前。親ノード: ResourcePoolBucket
Group	文字列	test-group-1	バケットグループの名前。
JoinTime	文字列	2024-11-29T08:42:32.000Z	バケットがリソースプールに参加した時刻 (ISO8601 形式)。親ノード: ResourcePoolBucket

例

クエリの例

GET /?resourcePoolBuckets&resourcePool=resource-pool-for-ai&continuation-token=abc&maxKeys=2
Host: oss-cn-hangzhou.aliyuncs.com
Date: Fri, 27 Dec 2024 03:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

成功レスポンスの例

HTTP/1.1 200 OK
Date: Sun, 11 Aug 2024 17:45:00 GMT
Content-Length: 510
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<ListResourcePoolBucketsResult>
  <ResourcePool>resource-pool-for-ai</ResourcePool>
  <ContinuationToken>abcd</ContinuationToken>
  <NextContinuationToken>defg</NextContinuationToken>
  <IsTruncated>true</IsTruncated>
  <ResourcePoolBucket>
    <Name>rp-bucket-01</Name>
    <Group>test-group-1</Group>
    <JoinTime>2024-11-29T08:42:32.000Z</JoinTime>
  </ResourcePoolBucket>
  <ResourcePoolBucket>
    <Name>rp-bucket-02</Name>
    <Group>test-group-1</Group>
    <JoinTime>2024-11-29T08:42:32.000Z</JoinTime>
  </ResourcePoolBucket>
</ListResourcePoolBucketsResult>

OSS SDK

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

コマンドラインツール ossutil

ListResourcePoolBuckets 操作に対応する ossutil コマンドについては、「list-resource-pool-buckets」をご参照ください。