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

调用ListResourcePools获取当前账号下的所有资源池信息，包括资源池名称以及资源池创建时间。

注意事项

当前资源池QoS为邀测功能。您在某个地域的OSS性能达到500Gbps及以上，请联系技术支持申请使用。
阿里云账号默认拥有获取当前账号下的所有资源池信息权限。如果您需要通过RAM用户或者STS的方式进行获取，您必须拥有oss:ListResourcePools权限。具体操作，请参见RAM Policy常见示例。

请求语法

GET /?resourcePool&max-keys=10&continuation-token=abcd
Host: oss-cn-shanghai.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求元素

名称	类型	是否必选	示例值	描述
max-keys	整数	否	10	限定此次返回资源池信息的最大条数。
continuation-token	字符串	否	abcd	限定从哪个资源池开始返回信息。

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

响应元素

名称	类型	示例值	描述
ListResourcePoolsResult	容器	不涉及	保存请求结果的容器。父节点：无
Region	字符串	oss-cn-hangzhou	资源池所在地域。父节点：ListResourcePoolsResult
Owner	字符串	103xxxx	资源池所属的账号UID。父节点：ListResourcePoolsResult
ContinuationToken	字符串	abcd	本次列举请求使用的ContinuationToken。父节点：ListResourcePoolsResult
NextContinuationToken	字符串	xyz	表明此次列举请求包含后续结果，需要将NextContinuationToken指定为下次列举请求的起点，继续获取结果。父节点：ListResourcePoolsResult
IsTruncated	布尔值	true	本次返回结果是否被截断。 true表示本次没有返回全部结果。 false表示本次已经返回了全部结果。父节点：ListResourcePoolsResult
ResourcePool	容器	不涉及	保存资源池列举结果的容器。父节点：ListResourcePoolsResult
Name	字符串	resource-pool-for-ai	资源池名称。父节点：ResourcePool
CreateTime	字符串	2024-11-29T08:42:32.000Z	资源池创建时间，格式为ISO8601。父节点：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: OSS qn6q****:77Dv****

返回示例

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>