調用GetResourcePoolInfo擷取指定資源集區的資訊。
注意事項
當前資源集區QoS為邀測功能。您在某個地區的OSS效能達到500Gbps及以上,請聯絡支援人員申請使用。
阿里雲帳號預設擁有擷取指定資源集區流控配置的許可權。如果您需要通過RAM使用者或者STS的方式進行擷取,您必須擁有
oss:GetResourcePoolInfo
許可權。具體操作,請參見RAM Policy常見樣本。
請求文法
GET /?resourcePoolInfo&resourcePool=ResourcePoolName
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
要求標頭
此介面僅涉及公用要求標頭。更多資訊,請參見公用要求標頭(Common Request Headers)。
請求元素
名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
resourcePool | 字串 | 是 | resource-pool-for-ai | 資源集區名稱。 |
回應標頭
此介面僅涉及公用回應標頭。更多資訊,請參見公用回應標頭(Common Response Headers)。
響應元素
名稱 | 類型 | 樣本值 | 描述 |
GetResourcePoolInfoResponse | 容器 | 不涉及 | 儲存請求結果的容器。 父節點:無 |
Region | 字串 | oss-cn-hangzhou | 資源集區所屬地區。 父節點:GetResourcePoolInfoResponse |
Name | 字串 | resource-pool-for-ai | 資源集區名稱。 父節點:GetResourcePoolInfoResponse |
Owner | 字串 | 103xxxx | 資源集區所屬的帳號UID。 父節點:GetResourcePoolInfoResponse |
CreateTime | 字串 | 2024-11-29T08:42:32.000Z | 資源集區建立時間,格式為ISO8601。 父節點:GetResourcePoolInfoResponse |
QoSConfiguration | 容器 | 不涉及 | 儲存資源集區流控配置資訊的容器 父節點:GetResourcePoolInfoResponse |
TotalUploadBandwidth | 整數 | 10 | 資源集區的總上傳頻寬,單位Gbps。 父節點:QoSConfiguration |
IntranetUploadBandwidth | 整數 | -1 | 資源集區的內網上傳頻寬,包括傳統網路和VPC網路的內網上傳頻寬,單位Gbps。 取值為-1,表示不限制內網上傳頻寬。 父節點:QoSConfiguration |
ExtranetUploadBandwidth | 整數 | -1 | 資源集區的外網上傳頻寬,包括公網和傳輸加速網域名稱的上傳頻寬,單位Gbps。 父節點:QoSConfiguration |
TotalDownloadBandwidth | 整數 | 10 | 資源集區的總下載頻寬,單位Gbps。 父節點:QoSConfiguration |
IntranetDownloadBandwidth | 整數 | -1 | 內網下載頻寬,包括傳統網路和VPC網路的內網下載請求,單位Gbps。 取值為-1,表示不限制內網下載頻寬。 父節點:QoSConfiguration |
ExtranetDownloadBandwidth | 整數 | -1 | 外網下載頻寬,包括公網和傳輸加速網域名稱的下載頻寬,單位Gbps。 父節點:QoSConfiguration |
樣本
請求樣本
GET /?resourcePoolInfo&resourcePool=resource-pool-for-ai 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: 624 Content-Type: application/xml <?xml version="1.0" encoding="UTF-8"?> <GetResourcePoolInfoResponse> <Region>oss-cn-hangzhou</Region> <Name>resource-pool-for-ai</Name> <Owner>103xxxx</Owner> <CreateTime>2024-11-29T08:42:32.000Z</CreateTime> <QoSConfiguration> <TotalUploadBandwidth>10</TotalUploadBandwidth> <IntranetUploadBandwidth>-1</IntranetUploadBandwidth> <ExtranetUploadBandwidth>-1</ExtranetUploadBandwidth> <TotalDownloadBandwidth>10</TotalDownloadBandwidth> <IntranetDownloadBandwidth>-1</IntranetDownloadBandwidth> <ExtranetDownloadBandwidth>-1</ExtranetDownloadBandwidth> </QoSConfiguration> </GetResourcePoolInfoResponse>
SDK
GetResourcePoolInfo介面所對應的各語言SDK如下:
命令列工具ossutil
GetResourcePoolInfo介面所對應的ossutil命令,請參見get-resource-pool-info。