Modify the priority and bandwidth Quality of Service (QoS) configurations for buckets and bucket groups in an OSS resource pool. This ensures that the minimum bandwidth commitment and priority rules comply with resource pool limits. - Object Storage Service

Precautions

The number of priority levels must be between 3 and 10.
Priority levels start from 1. A higher number indicates a higher priority.
If you do not configure a default minimum bandwidth commitment (DefaultGuaranteedQosConfiguration), you must configure one for each priority level. If a default is configured, any priority level without a specific commitment will use the default value.
The sum of a minimum bandwidth commitment item (such as TotalUploadBandwidth) across all priority levels cannot exceed the value of the corresponding item in the resource pool.
A minimum bandwidth commitment for a priority level can be set to -1 only if the value of the corresponding item in the resource pool is -1.
If a bucket and its bucket group have different priority configurations, the bucket group's priority takes precedence.

Request syntax

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

Request elements

Name	Type	Parameter Position	Description
resourcePool	string	Query	The name of the target resource pool.
PriorityQosConfiguration	container	Body	A container for the priority throttling configuration of the resource pool. Parent node: None
PriorityCount	Integer	-	The number of priority levels. Valid values: 3 to 10. Parent node: PriorityQosConfiguration
DefaultPriorityLevel	Integer	-	The default priority level. Valid values: 1 to PriorityCount. Parent node: PriorityQosConfiguration
DefaultGuaranteedQosConfiguration	container	-	The default minimum bandwidth commitment. If not configured, you must specify a minimum bandwidth commitment for each priority level. If configured, priority levels without a specific commitment use this default value. Parent node: PriorityQosConfiguration
QosPriorityLevelConfiguration	container	-	A container for the throttling configuration of a specific priority level. Parent node: PriorityQosConfiguration
PriorityLevel	Integer	-	The priority level. Valid values: 1 to PriorityCount. Parent node: QosPriorityLevelConfiguration
GuaranteedQosConfiguration	container	-	A container for the minimum bandwidth commitment of a specific priority level. Parent node: QosPriorityLevelConfiguration
TotalUploadBandwidth	Integer	-	The total minimum upload bandwidth commitment. Unit: Gbps. Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration
IntranetUploadBandwidth	Integer	-	The minimum upload bandwidth commitment for the internal network. Unit: Gbps. This includes requests from internal networks such as classic network and VPC. Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration
ExtranetUploadBandwidth	Integer	-	The minimum upload bandwidth commitment for the public network. Unit: Gbps. This includes requests from public networks such as the Internet and CDN. Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration
TotalDownloadBandwidth	Integer	-	The total minimum download bandwidth commitment. Unit: Gbps. Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration
IntranetDownloadBandwidth	Integer	-	The minimum download bandwidth commitment for the internal network. Unit: Gbps. This includes requests from internal networks such as classic network and VPC. Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration
ExtranetDownloadBandwidth	Integer	-	The minimum download bandwidth commitment for the public network. Unit: Gbps. This includes requests from public networks such as the Internet and CDN. Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration
Subjects	container	-	A container for the throttling objects, including buckets and bucket groups. Parent node: QosPriorityLevelConfiguration
Bucket	string	-	The bucket name. Parent node: Subjects
BucketGroup	string	-	The bucket group name. Parent node: Subjects

Examples

Request example

PUT /?priorityQos&resourcePool=ResoucePoolName
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>4</PriorityCount>
  <DefaultPriorityLevel>3</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>
  </QosPriorityLevelConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>2</PriorityLevel>
    <GuaranteedQosConfiguration>
      <TotalUploadBandwidth>20</TotalUploadBandwidth>
      <ToTalDownloadBandwidth>20</ToTalDownloadBandwidth>
      <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth>
      <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
      <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
      <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
    </GuaranteedQosConfiguration>
    <Subjects>
      <BucketGroup>bucketGroup-02</BucketGroup>
      <Bucket>bucket-02</Bucket>
    </Subjects>
  </QosPriorityLevelConfiguration>
</PriorityQosConfiguration>

Response example

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

SDK

The following SDKs support this operation:

Go V2

ossutil command line tool

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