All Products
Search

This Product

    Object Storage Service:PutResourcePoolRequesterPriorityQosConfiguration

    Document Center

    Object Storage Service:PutResourcePoolRequesterPriorityQosConfiguration

    Last Updated:Dec 03, 2025

    The PutResourcePoolRequesterPriorityQosConfiguration operation modifies the requester priority-based throttling configuration for a resource pool.

    Notes

    • The number of priority levels must be an integer from 3 to 10.

    • Priority levels start from 1. A larger number indicates a higher priority.

    • If you do not specify default minimum bandwidth commitment configurations, you must configure a minimum bandwidth commitment for each priority level. If you specify default configurations, priority levels that do not have a specific minimum bandwidth commitment use the default configurations.

    • For each configuration item in the minimum bandwidth commitment configuration, such as TotalUploadBandwidth or IntranetDownloadBandwidth, the sum of the values across all priority levels cannot exceed the value of the corresponding configuration item for the resource pool.

    • You can set the value of an item in the priority-based minimum bandwidth commitment to -1 only if the value of the corresponding configuration item for the resource pool is also -1.

    Request syntax

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

    Request elements

    Name

    Type

    Location

    Description

    resourcePool

    String

    Query

    The name of the target resource pool.

    PriorityQosConfiguration

    Container

    Body

    A container for the priority-based throttling configurations of the resource pool.

    Parent node: None

    PriorityCount

    Integer

    -

    The number of priority levels. The value must be an integer from 3 to 10.

    Parent node: PriorityQosConfiguration

    DefaultPriorityLevel

    Integer

    -

    The default priority level. The value must be an integer from 1 to the value of PriorityCount.

    Parent node: PriorityQosConfiguration

    DefaultGuaranteedQosConfiguration

    Container

    -

    The default minimum bandwidth commitment configuration. If this node is not specified, you must configure a minimum bandwidth commitment for each priority level. Otherwise, priority levels without a specific minimum bandwidth commitment use this default configuration.

    Parent node: PriorityQosConfiguration

    QosPriorityLevelConfiguration

    Container

    -

    A container for the throttling configuration of a specific priority level.

    Parent node: PriorityQosConfiguration

    PriorityLevel

    Integer

    -

    The priority level. The value must be an integer from 1 to the value of PriorityCount.

    Parent node: QosPriorityLevelConfiguration

    GuaranteedQosConfiguration

    Container

    -

    A container for the minimum bandwidth commitment configuration of a specific priority level.

    Parent node: QosPriorityLevelConfiguration

    TotalUploadBandwidth

    Integer

    -

    The minimum total upload bandwidth. Unit: Gbit/s.

    Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration

    IntranetUploadBandwidth

    Integer

    -

    The minimum internal network upload bandwidth. This includes requests from internal networks, such as classic network and VPC. Unit: Gbit/s.

    Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration

    ExtranetUploadBandwidth

    Integer

    -

    The minimum external network upload bandwidth. This includes requests from external networks, such as the public network and CDN. Unit: Gbit/s.

    Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration

    TotalDownloadBandwidth

    Integer

    -

    The minimum total download bandwidth. Unit: Gbit/s.

    Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration

    IntranetDownloadBandwidth

    Integer

    -

    The minimum internal network download bandwidth. This includes requests from internal networks, such as classic network and VPC. Unit: Gbit/s.

    Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration

    ExtranetDownloadBandwidth

    Integer

    -

    The minimum external network download bandwidth. This includes requests from external networks, such as the public network and CDN. Unit: Gbit/s.

    Parent node: DefaultGuaranteedQosConfiguration or GuaranteedQosConfiguration

    Subjects

    Container

    -

    A container for the throttling objects that are subject to a specific priority level. For requester priority-based throttling, the child element can only be Requester.

    Parent node: QosPriorityLevelConfiguration

    Requester

    String

    -

    The UID of the requester that is subject to the current priority level.

    Parent node: Subjects

    Examples

    • Request example

      PUT /?requesterPriorityQos&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

<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>

    • Response example

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

    SDKs

    The SDKs for the PutResourcePoolRequesterPriorityQosConfiguration operation are as follows:

    ossutil command-line tool

    For the ossutil command that corresponds to the PutResourcePoolRequesterPriorityQosConfiguration operation, see put-resource-pool-requester-priority-qos-configuration.