ListResourcePoolBuckets_对象存储(OSS)-阿里云帮助中心

调用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	本次返回结果是否被截断。 true表示本次没有返回全部结果。 false表示本次已经返回了全部结果。父节点：ListResourcePoolBucketsResult
ResourcePoolBucket	容器	不涉及	保存资源池中Bucket列举结果的容器。父节点：ListResourcePoolBucketsResult
Name	字符串	rp-bucket-01	Bucket名称。父节点：ResourcePoolBucket
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>
    <JoinTime>2024-11-29T08:42:32.000Z</JoinTime>
  </ResourcePoolBucket>
  <ResourcePoolBucket>
    <Name>rp-bucket-02</Name>
    <JoinTime>2024-11-29T08:42:32.000Z</JoinTime>
  </ResourcePoolBucket>
</ListResourcePoolBucketsResult>