调用PutResourcePoolRequesterPriorityQosConfiguration修改资源池请求者优先级流控配置-对象存储-阿里云

调用PutResourcePoolRequesterPriorityQosConfiguration接口修改资源池请求者的优先级流控配置。

注意事项

优先级数量的合法范围为3到10。
当默认保底带宽配置不存在时，每个优先级都必须配置保底带宽。如果存在默认保底带宽配置，未单独配置保底带宽的优先级将使用默认配置。
保底带宽配置中每个配置项（如TotalUploadBandwidth或IntranetDownloadBandwidth）的各优先级之和不能超过资源池对应配置项的值。
当资源池中某个配置项的值为-1时，优先级保底带宽中对应配置项可设置为-1；否则不能设置为-1。

请求语法

PUT /?requesterPriorityQos&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
GuranteedQosConfiguratino	容器	-	保存特定优先级保底带宽配置的容器。父节点：QosPriorityLevelConfiguration
TotalUploadBandwidth	整数	-	总上传保底带宽配置，单位为Gbps。父节点：DefaultGuaranteedQosConfiguration或GuranteedQosConfiguratino
IntranetUploadBandwidth	整数	-	内网上传保底带宽配置，包括经典网络内网上传和VPC网络内网上传等来自内网的请求，单位为Gbps。父节点：DefaultGuaranteedQosConfiguration或GuranteedQosConfiguratino
ExtranetUploadBandwidth	整数	-	外网上传保底带宽配置，包括公网上传和CDN上传等来自外网的请求，单位为Gbps。父节点：DefaultGuaranteedQosConfiguration或GuranteedQosConfiguratino
TotalDownloadBandwidth	整数	-	总下载保底带宽配置，单位为Gbps。父节点：DefaultGuaranteedQosConfiguration或GuranteedQosConfiguratino
IntranetDownloadBandwidth	整数	-	内网下载保底带宽配置，包括经典网络内网下载和VPC网络内网下载等来自内网的请求，单位为Gbps。父节点：DefaultGuaranteedQosConfiguration或GuranteedQosConfiguratino
ExtranetDownloadBandwidth	整数	-	外网下载保底带宽配置，包括公网下载和CDN下载等来自外网的请求，单位为Gbps。父节点：DefaultGuaranteedQosConfiguration或GuranteedQosConfiguratino
Subjects	容器	-	保存按特定优先级生效的流控对象的容器。对于请求者优先级流控，子元素只能为Requester。父节点：QosPriorityLevelConfiguration
Requester	字符串	-	按当前优先级生效的请求者UID。父节点：Subjects

示例

请求示例

PUT /?requesterPriorityQos&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>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>
    <GuranteedQosConfiguration>
      <TotalUploadBandwith>20</TotalUploadBandwith>
      <ToTalDownloadBandwith>20</ToTalDownloadBandwith>
      <ExtranetUploadBandwith>10</ExtranetUploadBandwith>
      <IntranetUploadBandwith>10</IntranetUploadBandwith>
      <ExtranetDownloadBandwith>10</ExtranetDownloadBandwith>
      <IntranetDownloadBandwith>10</IntranetDownloadBandwith>
    </GuranteedQosConfiguration>
    <Subjects>
      <Requester>2387497xx390843</Requester>
      <Requester>348397xxx348793</Requester>
    </Subjects>
  </QosPriorityLevelConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>5</PriorityLevel>
    <GuranteedQosConfiguration>
      <TotalUploadBandwith>20</TotalUploadBandwith>
      <ToTalDownloadBandwith>20</ToTalDownloadBandwith>
      <ExtranetUploadBandwith>10</ExtranetUploadBandwith>
      <IntranetUploadBandwith>10</IntranetUploadBandwith>
      <ExtranetDownloadBandwith>10</ExtranetDownloadBandwith>
      <IntranetDownloadBandwith>10</IntranetDownloadBandwith>
    </GuranteedQosConfiguration>
    <Subjects>
      <Requester>2387497xx390843</Requester>
      <Requester>348397xxx348793</Requester>
    </Subjects>
  </QosPriorityLevelConfiguration>
</PriorityQosConfiguration>

响应示例

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

SDK

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

设置请求者在资源池的优先级QoS配置

命令行工具ossutil

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