Lists the quality of service (QoS) throttling configurations for all requesters (RAM users) accessing a specific resource pool.
Resource pool QoS is in invitational preview. To apply, your OSS throughput in a specific region must be greater than or equal to 500 Gbit/s. Contact technical support to apply.
Prerequisites
Before you begin, ensure that you have:
Access to the target resource pool (Alibaba Cloud accounts have this permission by default)
For RAM users and Security Token Service (STS) sessions: the
oss:ListResourcePoolRequesterQoSInfospermission. For details, see Attach a custom policy to a RAM user
Syntax
ossutil api invoke-operation --op-name list-resource-pool-requester-qos-infos --method GET --parameters resourcePool=<resource-pool> --parameters requesterQosInfo [--parameters continuation-token=<continuation-token>] [--parameters max-keys=<max-keys>]Parameters
Required
| Parameter | Type | Description |
|---|---|---|
resourcePool=<resource-pool> | string | The name of the resource pool to query. |
requesterQosInfo | flag | Instructs the API to return per-requester QoS configurations. No value required. |
Optional
| Parameter | Type | Description |
|---|---|---|
continuation-token=<continuation-token> | string | The requester ID from which to start listing throttling configurations. |
max-keys=<max-keys> | string | The maximum number of entries to return per page. |
For global command-line options, see Global command-line options.
Examples
List all throttling configurations in a resource pool
ossutil api invoke-operation --op-name list-resource-pool-requester-qos-infos --method GET --parameters resourcePool=examplePool --parameters requesterQosInfoList configurations with pagination
The following command retrieves up to 10 configurations starting from requester ID 202835923910178019:
ossutil api invoke-operation --op-name list-resource-pool-requester-qos-infos --method GET --parameters resourcePool=examplePool --parameters requesterQosInfo --parameters continuation-token=202835923910178019 --parameters max-keys=10