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

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

注意事项

优先级数量的合法范围为3到10。
优先级序号从1开始，数字越大，优先级越高。
当默认保底带宽配置不存在时，每个优先级都必须配置保底带宽。如果存在默认保底带宽配置，未单独配置保底带宽的优先级将使用默认配置。
保底带宽配置中每个配置项（如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	整数	-	默认优先级。合法范围为1到PriorityCount的整数。父节点：PriorityQosConfiguration
DefaultGuaranteedQosConfiguration	容器	-	默认保底带宽配置。当该节点不存在时，每个优先级都必须配置保底带宽；否则，未配置保底带宽的优先级将使用此默认配置。父节点：PriorityQosConfiguration
QosPriorityLevelConfiguration	容器	-	保存特定优先级流控配置的容器。父节点：PriorityQosConfiguration
PriorityLevel	整数	-	优先级。合法范围为1到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	容器	-	保存按特定优先级生效的流控对象的容器。对于请求者优先级流控，子元素只能为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>
    <GuaranteedQosConfiguration>
      <TotalUploadBandwidth>20</TotalUploadBandwidth>
      <ToTalDownloadBandwidth>20</ToTalDownloadBandwidth>
      <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth>
      <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
      <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
      <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
    </GuaranteedQosConfiguration>
    <Subjects>
      <Requester>2387497xx390843</Requester>
      <Requester>348397xxx348793</Requester>
    </Subjects>
  </QosPriorityLevelConfiguration>
  <QosPriorityLevelConfiguration>
    <PriorityLevel>5</PriorityLevel>
    <GuaranteedQosConfiguration>
      <TotalUploadBandwidth>20</TotalUploadBandwidth>
      <ToTalDownloadBandwidth>20</ToTalDownloadBandwidth>
      <ExtranetUploadBandwidth>10</ExtranetUploadBandwidth>
      <IntranetUploadBandwidth>10</IntranetUploadBandwidth>
      <ExtranetDownloadBandwidth>10</ExtranetDownloadBandwidth>
      <IntranetDownloadBandwidth>10</IntranetDownloadBandwidth>
    </GuaranteedQosConfiguration>
    <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。