调用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。