The GetResourcePoolRequesterPriorityQosConfiguration operation retrieves the priority-based throttling and bandwidth configurations for requesters in a specified resource pool.-Object Storage Service(OSS)-阿里云帮助中心

Request syntax

GET /?requesterPriorityQos&resourcePool=ResourcePoolName HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request elements

Name	Type	Required	Description
resourcePool	String	Yes	The name of the resource pool to query. The name must be unique within the region for the current Alibaba Cloud account.

Response elements

Name	Type	Description
PriorityQosConfiguration	Container	Root container for the priority QoS configuration of the resource pool. Parent node: None
PriorityCount	Integer	Total number of supported priority levels. Valid values: 3 to 10. Parent node: `PriorityQosConfiguration`
DefaultPriorityLevel	Integer	Default priority level assigned to requesters that do not match any specific priority rules. Valid values: `1` to the value of `PriorityCount`. Parent node: `PriorityQosConfiguration`
DefaultGuaranteedQosConfiguration	Container	Default guaranteed bandwidth configuration. If a specific priority level lacks an explicit guaranteed bandwidth configuration, it inherits settings from this container. If this node is omitted, guaranteed bandwidth must be configured for each priority level individually. Parent node: `PriorityQosConfiguration`
TotalUploadBandwidth	Integer	Total guaranteed upload bandwidth. Unit: Gbps. Parent node: `DefaultGuaranteedQosConfiguration` or `GuaranteedQosConfiguration`
IntranetUploadBandwidth	Integer	Guaranteed upload bandwidth for internal network traffic (such as Classic Network and VPC). Unit: Gbps. Parent node: `DefaultGuaranteedQosConfiguration` or `GuaranteedQosConfiguration`
ExtranetUploadBandwidth	Integer	Guaranteed upload bandwidth for external network traffic (such as the Internet and CDN origin fetch). Unit: Gbps. Parent node: `DefaultGuaranteedQosConfiguration` or `GuaranteedQosConfiguration`
TotalDownloadBandwidth	Integer	Total guaranteed download bandwidth. Unit: Gbps. Parent node: `DefaultGuaranteedQosConfiguration` or `GuaranteedQosConfiguration`
IntranetDownloadBandwidth	Integer	Guaranteed download bandwidth for internal network traffic (such as Classic Network and VPC). Unit: Gbps. Parent node: `DefaultGuaranteedQosConfiguration` or `GuaranteedQosConfiguration`
ExtranetDownloadBandwidth	Integer	Guaranteed download bandwidth for external network traffic (such as the Internet and CDN origin fetch). Unit: Gbps. Parent node: `DefaultGuaranteedQosConfiguration` or `GuaranteedQosConfiguration`
QosPriorityLevelConfiguration	Container	Container for a specific priority level's QoS configuration. Multiple containers are supported. Parent node: `PriorityQosConfiguration`
PriorityLevel	Integer	Priority level. Valid values: `1` to the value of `PriorityCount`. Parent node: `QosPriorityLevelConfiguration`
GuaranteedQosConfiguration	Container	Container for the guaranteed bandwidth configuration of this priority level. Parent node: `QosPriorityLevelConfiguration`
Subjects	Container	Container for the entities to which this priority rule applies. For requester-level priority QoS configuration, the only valid child element is `Requester`. Parent node: `QosPriorityLevelConfiguration`
Requester	String	Alibaba Cloud account ID (UID) of the requester to which this priority rule applies. Parent node: Subjects

Examples

Request example

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****

Response example

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

The following SDK supports the GetResourcePoolRequesterPriorityQosConfiguration operation:

Go SDK V2

ossutil

The ossutil CLI supports the GetResourcePoolRequesterPriorityQosConfiguration operation. For command details, see get-resource-pool-requester-priority-qos-configuration.