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

ListResourcePoolBucketGroups 操作は、指定されたリソースプール内のバケットグループを一覧表示します。

使用方法

リソースプール QoS は招待プレビュー中です。リージョン内の OSS バケットのスループットが 500 Gbit/s に達した場合、または 500 Gbit/s を超えた場合は、テクニカルサポートに連絡して、この機能を申請できます。
デフォルトでは、Alibaba Cloud アカウントは、アカウント内のリソースに対するフルパーミッションを持っています。 RAM ユーザーとして、または RAM ロールを使用して操作を実行する場合は、Alibaba Cloud アカウントの所有者または管理者に oss:ListResourcePoolBucketGroups 権限を RAM ポリシーまたはバケットポリシーを使用して付与するように依頼してください。

リクエスト構文

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

リクエストヘッダー

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

リクエスト要素

名前	タイプ	必須	例	説明
resourcePool	文字列	はい	resource-pool-for-ai	リソースプールの名前。
max-keys	整数	いいえ	2	リソースプールから返すバケットの最大数。
continuation-token	文字列	いいえ	abc	リスト操作の開始位置を示すトークン。

レスポンスヘッダー

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

レスポンス要素

名前	タイプ	例	説明
ListResourcePoolBucketGroupsResult	コンテナー	N/A	リクエストの結果を格納するコンテナー。親ノード: なし
ResourcePool	文字列	resource-pool-for-ai	リソースプールの名前。親ノード: ListResourcePoolBucketGroupsResult
ContinuationToken	文字列	abcd	この ListResourcePoolBucketGroups リクエストで使用された continuationToken。親ノード: ListResourcePoolBucketGroupsResult
NextContinuationToken	文字列	defg	この ListResourcePoolBucketGroups リクエストに後続の結果が含まれていることを示します。 NextContinuationToken の値は、別の ListResourcePoolBucketGroups リクエストで ContinuationToken の値として使用して、後続のエントリをクエリできます。親ノード: ListResourcePoolBucketGroupsResult
IsTruncated	ブール値	true	結果が切り捨てられているかどうかを示します。 true: 今回はすべてのエントリが返されないことを示します。 false: 今回はすべてのエントリが返されることを示します。親ノード: ListResourcePoolBucketGroupsResult
ResourcePoolBucketGroup	コンテナー	N/A	バケットグループに関する情報を格納するコンテナー。親ノード: ListResourcePoolBucketGroupsResult
Name	文字列	test-group	バケットグループの名前。親ノード: ResourcePoolBucketGroup
GroupBucketInfo	コンテナー	N/A	バケットグループに関する情報。親ノード: ResourcePoolBucketGroup
BucketName	文字列	examplebucket	バケットの名前。親ノード: GroupBucketInfo

例

リクエスト例

GET /?resourcePoolBucketGroup&resourcePool=resource-pool-for-ai&continuation-token=abc&maxKeys=2
Host: oss-cn-shanghai.aliyuncs.com
Date: Sun, 11 Aug 2024 17:45:00 GMT
Authorization: SignatureValue

レスポンス例

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

<?xml version="1.0" encoding="UTF-8"?>
<ListResourcePoolBucketGroupsResult>
  <ResourcePool>rp-for-ai</ResourcePool>
  <ContinuationToken>abcd</ContinuationToken>
  <NextContinuationToken>defg</NextContinuationToken>
  <IsTruncated>true</IsTruncated>
  <ResourcePoolBucketGroup>
    <Name>test-group<Name/>
    <GroupBucketInfo>
      <BucketName>bucket-01</BucketName>
    <GroupBucketInfo>
    <GroupBucketInfo>
      <BucketName>bucket-02</BucketName>
    <GroupBucketInfo>
  </ResourcePoolBucketGroup>
</ListResourcePoolBucketGroupsResult>

SDK

以下の OSS SDK は、ListResourcePoolBucketGroups 操作をカプセル化して、使用を簡素化します。