调用GetResourcePoolRequesterPriorityQosConfiguration接口，获取指定资源池内，基于请求者身份的优先级流控配置。
请求语法
GET /?requesterPriorityQos&resourcePool=ResourcePoolName HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue请求元素
名称 | 类型 | 是否必需 | 描述 |
resourcePool | String | 是 | 待查询的资源池名称。资源池名称在当前阿里云账号的当前地域内唯一。 |
响应元素
名称 | 类型 | 描述 |
PriorityQosConfiguration | 容器 | 保存资源池优先级流控配置信息的根容器。 |
PriorityCount | Integer | 优先级总数。取值范围为3~10。 |
DefaultPriorityLevel | Integer | 默认优先级。未匹配到任何特定优先级规则的请求者将应用此优先级。 |
DefaultGuaranteedQosConfiguration | 容器 | 默认的保底带宽配置。如果某个优先级未显式配置保底带宽，则继承此处的默认配置。如果此节点不存在，则要求每个优先级都必须独立配置保底带宽。 |
TotalUploadBandwidth | Integer | 总上传保底带宽，单位为Gbps。 |
IntranetUploadBandwidth | Integer | 内网（经典网络、VPC等）上传保底带宽，单位为Gbps。 |
ExtranetUploadBandwidth | Integer | 外网（公网、CDN回源等）上传保底带宽，单位为Gbps。 |
TotalDownloadBandwidth | Integer | 总下载保底带宽，单位为Gbps。 |
IntranetDownloadBandwidth | Integer | 内网（经典网络、VPC等）下载保底带宽，单位为Gbps。 |
ExtranetDownloadBandwidth | Integer | 外网（公网、CDN回源等）下载保底带宽，单位为Gbps。 |
QosPriorityLevelConfiguration | 容器 | 保存特定优先级流控配置的容器，可包含多个。 |
PriorityLevel | Integer | 优先级级别。取值范围为： |
GuaranteedQosConfiguration | 容器 | 保存该特定优先级的保底带宽配置。 |
Subjects | 容器 | 应用当前优先级规则的对象列表。对于请求者优先级流控，其子元素只能是 |
Requester | String | 应用当前优先级的请求者阿里云账号UID。 |
示例
请求示例
GET /?requesterPriorityQos&resourcePool=my-test-pool HTTP/1.1 Host: oss-cn-hangzhou.aliyuncs.com Date: Fri, 10 Oct 2025 07:38:42 GMT Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:kZoYNv66bsmc10+dcGKw5x2P****响应示例
HTTP/1.1 200 OK Date: Fri, 10 Oct 2025 07:38:42 GMT Content-Type: application/xml Content-Length: 648 x-oss-request-id: 6735A43C2EBE61393635**** <?xml version="1.0" encoding="UTF-8"?> <PriorityQosConfiguration> <PriorityCount>5</PriorityCount> <DefaultPriorityLevel>1</DefaultPriorityLevel> <DefaultGuaranteedQosConfiguration> <TotalUploadBandwidth>10</TotalUploadBandwidth> <IntranetUploadBandwidth>5</IntranetUploadBandwidth> <ExtranetUploadBandwidth>5</ExtranetUploadBandwidth> <TotalDownloadBandwidth>20</TotalDownloadBandwidth> <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth> <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth> </DefaultGuaranteedQosConfiguration> <QosPriorityLevelConfiguration> <PriorityLevel>1</PriorityLevel> <GuaranteedQosConfiguration> <TotalUploadBandwidth>20</TotalUploadBandwidth> <TotalDownloadBandwidth>20</TotalDownloadBandwidth> <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth> <IntranetUploadBandwidth>10</IntranetUploadBandwidth> <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth> <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth> </GuaranteedQosConfiguration> <Subjects> <Requester>1111111111111111</Requester> <Requester>2222222222222222</Requester> </Subjects> </QosPriorityLevelConfiguration> <QosPriorityLevelConfiguration> <PriorityLevel>5</PriorityLevel> <GuaranteedQosConfiguration> <TotalUploadBandwidth>50</TotalUploadBandwidth> <TotalDownloadBandwidth>50</TotalDownloadBandwidth> <ExtranetUploadBandwidth>25</ExtranetUploadBandwidth> <IntranetUploadBandwidth>25</IntranetUploadBandwidth> <ExtranetDownloadBandwidth>25</ExtranetDownloadBandwidth> <IntranetDownloadBandwidth>25</IntranetDownloadBandwidth> </GuaranteedQosConfiguration> <Subjects> <Requester>3333333333333333</Requester> <Requester>4444444444444444</Requester> </Subjects> </QosPriorityLevelConfiguration> </PriorityQosConfiguration>
SDK
GetResourcePoolRequesterPriorityQosConfiguration接口所对应的各语言SDK如下：
命令行工具ossutil
GetResourcePoolRequesterPriorityQosConfiguration接口所对应的ossutil命令，请参见get-resource-pool-requester-priority-qos-configuration。