Retrieve the priority Quality of Service (QoS) throttling configurations for a specified resource pool, including bandwidth allocation and applicable objects for default and specific priorities.-Object Storage Service(OSS)-阿里云帮助中心

Request syntax

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

Request elements

Name	Type	Location	Required	Description
resourcePool	string	Query	Yes	The name of the resource pool to query.

Response elements

Name	Type	Location	Description
PriorityQosConfiguration	container	Body	The root container for the priority QoS configuration. Parent node: None
PriorityCount	integer	-	The total number of priority levels. Valid values: 3 to 10. Parent node: `PriorityQosConfiguration`
DefaultPriorityLevel	integer	-	The default priority level. Valid values: 3 to the value of `PriorityCount`. Parent node: `PriorityQosConfiguration`
DefaultGuaranteedQosConfiguration	container	-	The container for the default guaranteed bandwidth configuration, which applies when no guaranteed bandwidth is explicitly configured for a specific priority level. Parent node: `PriorityQosConfiguration`
QosPriorityLevelConfiguration	container	-	The container for the QoS configuration of a specific priority level. Multiple containers can be returned. Parent node: `PriorityQosConfiguration`
PriorityLevel	integer	-	The priority level of the current configuration. Valid values: 3 to the value of `PriorityCount`. Parent node: `QosPriorityLevelConfiguration`
GuaranteedQosConfiguration	container	-	The container for the guaranteed bandwidth configuration of the current priority level. Parent node: `QosPriorityLevelConfiguration`
TotalUploadBandwidth	integer	-	The total guaranteed upload bandwidth. Unit: Gbps. Parent node: `DefaultGuaranteedQosConfiguration` or `GuaranteedQosConfiguration`
IntranetUploadBandwidth	integer	-	The guaranteed upload bandwidth for internal network traffic, including requests from internal networks such as classic networks and VPCs. Unit: Gbps. Parent node: `DefaultGuaranteedQosConfiguration` or `GuaranteedQosConfiguration`
ExtranetUploadBandwidth	integer	-	The guaranteed upload bandwidth for external network traffic, including requests from the Internet (public network) and Alibaba Cloud CDN. Unit: Gbps. Parent node: `DefaultGuaranteedQosConfiguration` or `GuaranteedQosConfiguration`
TotalDownloadBandwidth	integer	-	The total guaranteed download bandwidth. Unit: Gbps. Parent node: `DefaultGuaranteedQosConfiguration` or `GuaranteedQosConfiguration`
IntranetDownloadBandwidth	integer	-	The guaranteed download bandwidth for internal network traffic, including requests from internal networks such as classic networks and VPCs. Unit: Gbps. Parent node: `DefaultGuaranteedQosConfiguration` or `GuaranteedQosConfiguration`
ExtranetDownloadBandwidth	integer	-	The guaranteed download bandwidth for external network traffic, including requests from the Internet (public network) and Alibaba Cloud CDN. Unit: Gbps. Parent node: `DefaultGuaranteedQosConfiguration` or `GuaranteedQosConfiguration`
Subjects	container	-	The container for the targets to which the current priority configuration applies, including buckets and bucket groups. Parent node: `QosPriorityLevelConfiguration`
Bucket	string	-	The name of the bucket to which the current priority configuration applies. Parent node: `Subjects`
BucketGroup	string	-	The name of the bucket group to which the current priority configuration applies. Parent node: `Subjects`

Examples

Request example

GET /?priorityQos&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

Response example

HTTP/1.1 200 OK
Date: Fri, 10 Oct 2025 07:38:42 GMT
Content-Type: application/xml
Content-Length: 586

<PriorityQosConfiguration>
  <PriorityCount>2</PriorityCount>
  <DefaultPriorityLevel>2</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>

SDK

The following SDK supports the GetResourcePoolPriorityQosConfiguration operation:

Go V2

ossutil

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