The PutResourcePoolRequesterPriorityQosConfiguration operation updates the requester priority-based throttling and minimum bandwidth commitment settings for a resource pool by using an XML configuration. - Object Storage Service

Notes

The number of priority levels must be an integer from 3 to 10.
Priority levels start from 1. A larger number indicates a higher priority.
If no default minimum bandwidth commitment is specified, you must configure a minimum bandwidth commitment for each priority level. Otherwise, priority levels without a specific configuration use the default values.
For each minimum bandwidth commitment item, such as TotalUploadBandwidth or IntranetDownloadBandwidth, the sum of values across all priority levels cannot exceed the corresponding resource pool value.
You can set a priority-based minimum bandwidth commitment item to -1 only if the corresponding resource pool item is also -1.

Request syntax

PUT /?requesterPriorityQos&resourcePool=ResourcePoolName
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Content-Type: application/xml
Content-Length: content length

Request elements

Name	Type	Location	Description
resourcePool	String	Query	The name of the target resource pool.
PriorityQosConfiguration	Container	Body	The container for priority-based throttling configurations of the resource pool. Parent node: None
PriorityCount	Integer	-	The number of priority levels. The value must be an integer from 3 to 10. Parent node: PriorityQosConfiguration
DefaultPriorityLevel	Integer	-	The default priority level. The value must be an integer from 1 to the value of PriorityCount. Parent node: PriorityQosConfiguration
DefaultGuaranteedQosConfiguration	Container	-	The default minimum bandwidth commitment. If not specified, you must configure a minimum bandwidth commitment for each priority level. Otherwise, priority levels without a specific configuration use the default values. Parent node: PriorityQosConfiguration
QosPriorityLevelConfiguration	Container	-	The throttling configuration for a specific priority level. Parent node: PriorityQosConfiguration
PriorityLevel	Integer	-	The priority level. The value must be an integer from 1 to the value of PriorityCount. Parent node: QosPriorityLevelConfiguration
GuaranteedQosConfiguration	Container	-	The minimum bandwidth commitment for a specific priority level. Parent node: QosPriorityLevelConfiguration
TotalUploadBandwidth	Integer	-	The minimum total upload bandwidth. Unit: Gbit/s. Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration
IntranetUploadBandwidth	Integer	-	The minimum internal network upload bandwidth, including classic network and VPC requests. Unit: Gbit/s. Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration
ExtranetUploadBandwidth	Integer	-	The minimum external network upload bandwidth, including public network and CDN requests. Unit: Gbit/s. Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration
TotalDownloadBandwidth	Integer	-	The minimum total download bandwidth. Unit: Gbit/s. Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration
IntranetDownloadBandwidth	Integer	-	The minimum internal network download bandwidth, including classic network and VPC requests. Unit: Gbit/s. Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration
ExtranetDownloadBandwidth	Integer	-	The minimum external network download bandwidth, including public network and CDN requests. Unit: Gbit/s. Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration
Subjects	Container	-	The throttling subjects assigned to a specific priority level. For requester priority-based throttling, the only supported child element is Requester. Parent node: QosPriorityLevelConfiguration
Requester	String	-	The UID of the requester assigned to this priority level. Parent node: Subjects

Examples

Request example

PUT /?requesterPriorityQos&resourcePool=ResourcePoolName
Host: oss-cn-shanghai.aliyuncs.com
Date: Fri, 10 Oct 2025 07:38:42 GMT
Content-Type: application/xml
Content-Length: content length

<PriorityQosConfiguration>
  <PriorityCount>5</PriorityCount>
  <DefaultPriorityLevel>1</DefaultPriorityLevel>
  <DefaultGuaranteedQosConfiguration>
    <TotalUploadBandwidth>10</TotalUploadBandwidth>
    <IntranetUploadBandwidth>20</IntranetUploadBandwidth>
    <ExtranetUploadBandwidth>30</ExtranetUploadBandwidth>
    <TotalDownloadBandwidth>40</TotalDownloadBandwidth>
    <IntranetDownloadBandwidth>50</IntranetDownloadBandwidth>
    <ExtranetDownloadBandwidth>60</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>2387497xx390843</Requester>
      <Requester>348397xxx348793</Requester>
    </Subjects>
  </QosPriorityLevelConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>5</PriorityLevel>
    <GuaranteedQosConfiguration>
      <TotalUploadBandwidth>20</TotalUploadBandwidth>
      <ToTalDownloadBandwidth>20</ToTalDownloadBandwidth>
      <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth>
      <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
      <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
      <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
    </GuaranteedQosConfiguration>
    <Subjects>
      <Requester>2387497xx390843</Requester>
      <Requester>348397xxx348793</Requester>
    </Subjects>
  </QosPriorityLevelConfiguration>
</PriorityQosConfiguration>

Response example

HTTP/1.1 200 OK
Date: Fri, 10 Oct 2025 07:38:42 GMT
Content-Length: 0

SDKs

SDKs for this operation:

Set priority-based QoS configuration for requesters in a resource pool

ossutil command-line tool

For the corresponding ossutil command, see put-resource-pool-requester-priority-qos-configuration.