通过PutResourcePoolPriorityQosConfiguration修改资源池中Bucket和BucketGroup的优先级流控配置-对象存储-阿里云

调用PutResourcePoolPriorityQosConfiguration接口，修改资源池中Bucket和BucketGroup的优先级流控配置。

注意事项

优先级数量的取值范围为3~10。
如果未配置默认保底带宽（DefaultGuaranteedQosConfiguration），则必须为每个优先级配置保底带宽。如果已配置默认保底带宽，则未单独配置保底带宽的优先级将使用该默认值。
所有优先级的各保底带宽配置项（例如TotalUploadBandwidth）之和，不能超过资源池中对应配置项的值。
仅当资源池中对应配置项的值为-1时，优先级的保底带宽配置项才可设置为-1。
当Bucket与其所属的BucketGroup配置了不同的优先级时，以BucketGroup的优先级为准。

请求语法

PUT /?priorityQos&resourcePool=ResourcePoolName
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	整数	-	内网上传保底带宽，单位为Gbps。包括经典网络和VPC等内网请求。父节点：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration
ExtranetUploadBandwidth	整数	-	外网上传保底带宽，单位为Gbps。包括公网和CDN等外网请求。父节点：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration
TotalDownloadBandwidth	整数	-	总下载保底带宽，单位为Gbps。父节点：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration
IntranetDownloadBandwidth	整数	-	内网下载保底带宽，单位为Gbps。包括经典网络和VPC等内网请求。父节点：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration
ExtranetDownloadBandwidth	整数	-	外网下载保底带宽，单位为Gbps。包括公网和CDN等外网请求。父节点：DefaultGuaranteedQosConfiguration或GuaranteedQosConfiguration
Subjects	容器	-	用于指定流控对象的容器，流控对象包括Bucket和BucketGroup。父节点：QosPriorityLevelConfiguration
Bucket	字符串	-	Bucket名称。父节点：Subjects
BucketGroup	字符串	-	BucketGroup名称。父节点：Subjects

示例

请求示例

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>
    <GuranteedQosConfiguration>
      <TotalUploadBandwith>20</TotalUploadBandwith>
      <ToTalDownloadBandwith>20</ToTalDownloadBandwith>
      <ExtranetUploadBandwith>10</ExtranetUploadBandwith>
      <IntranetUploadBandwith>10</IntranetUploadBandwith>
      <ExtranetDownloadBandwith>10</ExtranetDownloadBandwith>
      <IntranetDownloadBandwith>10</IntranetDownloadBandwith>
    </GuranteedQosConfiguration>
  </QosPriorityLevelConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>2</PriorityLevel>
    <GuranteedQosConfiguration>
      <TotalUploadBandwith>20</TotalUploadBandwith>
      <ToTalDownloadBandwith>20</ToTalDownloadBandwith>
      <ExtranetUploadBandwith>10</ExtranetUploadBandwith>
      <IntranetUploadBandwith>10</IntranetUploadBandwith>
      <ExtranetDownloadBandwith>10</ExtranetDownloadBandwith>
      <IntranetDownloadBandwith>10</IntranetDownloadBandwith>
    </GuranteedQosConfiguration>
    <Subjects>
      <BucketGroup>bucketGroup-02</BucketGroup>
      <Bucket>bucket-02</Bucket>
    </Subjects>
  </QosPriorityLevelConfiguration>
</PriorityQosConfiguration>

响应示例

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

SDK

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

Go V2

命令行工具ossutil

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