ListResourcePools - Object Storage Service

調用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: 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

ListResourcePools介面所對應的各語言SDK如下：

命令列工具ossutil

ListResourcePools介面所對應的ossutil命令，請參見list-resource-pools。