All Products
Search
Document Center

Object Storage Service:put-resource-pool-requester-priority-qos-configuration

Last Updated:Nov 11, 2025

You can use the put-resource-pool-requester-priority-qos-configuration command to manage access priorities and Quality of Service (QoS) controls for different requesters in a resource pool.

Permissions

By default, an Alibaba Cloud account has all permissions. In contrast, a Resource Access Management (RAM) user or RAM role has no permissions by default. The Alibaba Cloud account or an administrator must grant permissions using a RAM policy or bucket policy.

API action

Description

oss:PutResourcePoolRequesterPriorityQosConfiguration

The permission to configure the requester priority QoS policy for a resource pool.

Command format

ossutil api invoke-operation --op-name put-resource-pool-requester-priority-qos-configuration --method PUT --parameters resourcePool=<resource-pool> --parameters requesterPriorityQos --body=file://<path-to-xml>

Parameters

Parameter

Type

Description

--op-name

string

The name of the operation. Set this to put-resource-pool-requester-priority-qos-configuration.

--method

string

The HTTP method. Set this to PUT.

--parameters resourcePool

string

The name of the resource pool to configure.

--parameters requesterPriorityQos

boolean

Specifies that the operation type is a requester priority QoS configuration.

--body

string

The path to the XML file that contains the QoS configuration. The format is file://<path-to-xml>.

Examples

Example 1: Configure the requester priority QoS policy for a resource pool

The following example shows how to set the requester priority QoS configuration for a specified resource pool.

ossutil api invoke-operation --op-name put-resource-pool-requester-priority-qos-configuration --method PUT --parameters resourcePool=hz-rp-03 --parameters requesterPriorityQos --body=file://requester-priority-qos.xml

Example 2: Update the QoS configuration of an existing resource pool

Updates the requester priority QoS policy for an existing resource pool.

ossutil api invoke-operation --op-name put-resource-pool-requester-priority-qos-configuration --method PUT --parameters resourcePool=production-pool --parameters requesterPriorityQos --body=file://updated-qos-config.xml