调用ListResourcePoolBuckets获取指定资源池包含的Bucket列表。
注意事项
当前资源池QoS为邀测功能。您在某个地域的OSS性能达到500Gbps及以上，请联系技术支持申请使用。
阿里云账号默认拥有获取指定资源池包含的Bucket列表权限。如果您需要通过RAM用户或者STS的方式进行获取，您必须拥有
oss:ListResourcePoolBuckets权限。具体操作，请参见RAM Policy常见示例。
请求语法
GET /?resourcePoolBuckets&resourcePool=ResourcePoolName&max-keys=2&continuation-token=abc
Host: oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue请求头
此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。
请求元素
名称 | 类型 | 是否必选 | 示例值 | 描述 |
resourcePool | 字符串 | 是 | resource-pool-for-ai | 请求的目标资源池名称。 |
max-keys | 整数 | 否 | 10 | 限定此次请求返回资源池中Bucket数量的最大个数。 |
continuation-token | 字符串 | 否 | rp-bucket-01 | 限定从哪个Bucket开始返回信息。 |
响应头
此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。
响应元素
名称 | 类型 | 示例值 | 描述 |
ListResourcePoolBucketsResult | 容器 | 不涉及 | 保存请求结果的容器。 父节点：无 |
ContinuationToken | 字符串 | abcd | 本次列举请求使用的ContinuationToken。 父节点：ListResourcePoolBucketsResult |
NextContinuationToken | 字符串 | xyz | 表明此次列举请求包含后续结果，需要将NextContinuationToken指定为下次列举请求的起点，继续获取结果。 父节点：ListResourcePoolBucketsResult |
IsTruncated | 布尔值 | true | 本次返回结果是否被截断。
父节点：ListResourcePoolBucketsResult |
ResourcePoolBucket | 容器 | 不涉及 | 保存资源池中Bucket列举结果的容器。 父节点：ListResourcePoolBucketsResult |
Name | 字符串 | rp-bucket-01 | Bucket名称。 父节点：ResourcePoolBucket |
Group | 字符串 | test-group-1 | BucketGroup名称。 |
JoinTime | 字符串 | 2024-11-29T08:42:32.000Z | Bucket加入资源池的时间，格式为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: OSS qn6q****:77Dv****返回示例
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>
命令行工具ossutil
ListResourcePoolBuckets接口所对应的ossutil命令，请参见list-resource-pool-buckets。