ListResourcePools を呼び出して、現在の Alibaba Cloud アカウントに関連付けられているすべてのリソースプールに関する詳細 (名前、作成時間など) を取得します。
注意事項
リソースプール QoS は招待プレビュー中です。リージョン内の OSS バケットのスループットが 500 Gbit/s に達しているか、超えている場合は、テクニカルサポート に連絡して、この機能を申請できます。
デフォルトでは、Alibaba Cloud アカウントは、アカウント下のすべてのリソースプールに関する情報にアクセスする権限を持っています。 RAM ユーザーまたは Security Token Service (STS) を介してこの情報にアクセスするには、
oss:ListResourcePools権限が必要です。詳細な手順については、「RAM ポリシーの例」をご参照ください。
リクエスト構文
GET /?resourcePool&max-keys=10&continuation-token=abcd
Host: oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueリクエストヘッダー
この操作には、共通のリクエストヘッダーのみが必要であり、特定のヘッダーは必要ありません。詳細については、「共通リクエストヘッダー」をご参照ください。
リクエスト要素
名前 | 種類 | 必須 | 値の例 | 説明 |
max-keys | Integer | いいえ | 10 | 今回返されるリソースプール情報エントリの最大数。 |
継続トークン | 文字列 | いいえ | abcd | 情報が返され始めるリソースプール。 |
レスポンスヘッダー
この操作では、共通レスポンスヘッダーのみが必要であり、特定のヘッダーは必要ありません。詳細については、「共通レスポンスヘッダー」をご参照ください。
レスポンス要素
名前 | タイプ | 値の例 | 説明 |
ListResourcePoolsResult | コンテナー | 該当なし | リクエストの結果を格納するコンテナー。 親ノード: なし |
Region | String | oss-cn-hangzhou | リソースプールが配置されているリージョン。 親ノード: ListResourcePoolsResult |
Owner | String | 103xxxx | リソースプールが属するアカウントの一意識別子 (UID)。 親ノード: ListResourcePoolsResult |
ContinuationToken | String | abcd | この ListResourcePools リクエストで使用される ContinuationToken。 親ノード: ListResourcePoolsResult |
NextContinuationToken | String | xyz | この ListResourcePools リクエストに後続の結果が含まれていることを示します。 NextContinuationToken の値は、後続の結果を照会するために ContinuationToken の値として使用されます。 親ノード: ListResourcePoolsResult |
IsTruncated | ブール値 | true | 照会された結果が切り捨てられるかどうかを示します。
親ノード: ListResourcePoolsResult |
ResourcePool | コンテナー | 該当なし | リソースプールリストの結果を格納するコンテナー。 親ノード: ListResourcePoolsResult |
Name | String | resource-pool-for-ai | リソースグループの名前。 親ノード: ResourcePool |
CreateTime | String | 2024-11-29T08:42:32.000Z | リソースプールが作成された時刻。時刻は ISO 8601 標準に準拠しています。 親ノード: ResourcePool |
例
クエリ例
GET /?resourcePool&max-keys=10&continuation-token=abcd 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: Fri, 27 Dec 2024 03:21:12 GMT Content-Length: 655 Content-Type: application/xml <?xml version="1.0" encoding="UTF-8"?> <ListResourcePoolsResult> <Region>oss-cn-hangzhou</Region> <Owner>103xxxx</Owner> <ContinuationToken>abcd</ContinuationToken> <NextContinuationToken>xyz</NextContinuationToken> <IsTruncated>true</IsTruncated> <ResourcePool> <Name>resource-pool-for-ai</Name> <CreateTime>2024-11-29T08:42:32.000Z</CreateTime> </ResourcePool> <ResourcePool> <Name>resource-pool-for-video</Name> <CreateTime>2024-11-29T08:42:32.000Z</CreateTime> </ResourcePool> <ResourcePool> <Name>resource-pool-for-datalake</Name> <CreateTime>2024-11-29T08:42:32.000Z</CreateTime> </ResourcePool> </ListResourcePoolsResult>
SDK
次のプログラミング言語に対応した OSS SDK を使用して、ListResourcePools を呼び出すことができます。
レスポンス要素
詳細については、「list-resource-pools」をご参照ください。