调用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: OSS qn6q****:77Dv****
返回示例
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>