调用GetResourcePoolPriorityQosConfiguration获取资源池的优先级流控配置-对象存储-阿里云

调用GetResourcePoolPriorityQosConfiguration接口获取指定资源池中Bucket与BucketGroup的优先级流控配置信息。

请求语法

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

请求元素

名称	类型	参数位置	必填	描述
resourcePool	字符串	Query	是	需要查询的资源池名称

响应元素

名称	类型	参数位置	描述
PriorityQosConfiguration	容器	Body	优先级流控配置信息的根容器父节点：无
PriorityCount	整数	-	优先级总数。取值范围：3~10 父节点：PriorityQosConfiguration
DefaultPriorityLevel	整数	-	默认优先级等级。取值范围：3~PriorityCount 父节点：PriorityQosConfiguration
DefaultGuaranteedQosConfiguration	容器	-	默认保底带宽配置容器。当某个优先级未单独配置保底带宽时，将使用此默认配置父节点：PriorityQosConfiguration
QosPriorityLevelConfiguration	容器	-	特定优先级流控配置容器，可包含多个优先级配置父节点：PriorityQosConfiguration
PriorityLevel	整数	-	当前配置的优先级等级。取值范围：3~PriorityCount 父节点：QosPriorityLevelConfiguration
GuaranteedQosConfiguration	容器	-	当前优先级的保底带宽配置容器父节点：QosPriorityLevelConfiguration
TotalUploadBandwidth	整数	-	总上传保底带宽，单位：Gbps 父节点：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration
IntranetUploadBandwidth	整数	-	内网上传保底带宽，包括经典网络和VPC网络等内网请求，单位：Gbps 父节点：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration
ExtranetUploadBandwidth	整数	-	外网上传保底带宽，包括公网和CDN等外网请求，单位：Gbps 父节点：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration
TotalDownloadBandwidth	整数	-	总下载保底带宽，单位：Gbps 父节点：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration
IntranetDownloadBandwidth	整数	-	内网下载保底带宽，包括经典网络和VPC网络等内网请求，单位：Gbps 父节点：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration
ExtranetDownloadBandwidth	整数	-	外网下载保底带宽，包括公网和CDN等外网请求，单位：Gbps 父节点：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration
Subjects	容器	-	应用当前优先级配置的对象容器，包含Bucket和BucketGroup 父节点：QosPriorityLevelConfiguration
Bucket	字符串	-	应用当前优先级配置的Bucket名称父节点：Subjects
BucketGroup	字符串	-	应用当前优先级配置的BucketGroup名称父节点：Subjects

示例

请求示例

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

响应示例

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

GetResourcePoolPriorityQosConfiguration接口所对应的各语言SDK如下：

Go V2

命令行工具ossutil

GetResourcePoolPriorityQosConfiguration接口所对应的ossutil命令，请参见get-resource-pool-priority-qos-configuration。