Lists all per-requester throttling configurations for a bucket.
The resource pool QoS feature is in invitational preview. To apply, your Object Storage Service (OSS) bucket throughput in a given region must be at or above 500 Gbit/s. Contact technical support to request access.
Prerequisites
Before you begin, ensure that you have:
The
oss:ListBucketRequesterQoSInfospermission (RAM users and Security Token Service (STS) roles only — Alibaba Cloud root accounts have this permission by default). See Attach a custom policy to a RAM user
Syntax
ossutil api invoke-operation --op-name list-bucket-requester-qos-infos --method GET --bucket <bucket-name> --parameters requesterQosInfo [--parameters continuation-token=<continuation-token>] [--parameters max-keys=<max-keys>]Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
--bucket | string | Yes | Name of the bucket |
--parameters requesterQosInfo | string | Yes | Identifies the operation type. Must be set to requesterQosInfo |
--parameters continuation-token=<value> | string | No | Resumes a paginated listing from the specified position |
--parameters max-keys=<value> | string | No | Maximum number of entries to return per page |
For all supported global command-line options, see Command-line options.
Examples
List all throttling configurations for a bucket:
ossutil api invoke-operation --op-name list-bucket-requester-qos-infos --method GET --bucket examplebucket --parameters requesterQosInfoPaginate results starting from a specific requester, with a page size of 2:
ossutil api invoke-operation --op-name list-bucket-requester-qos-infos --method GET --bucket examplebucket --parameters requesterQosInfo --parameters continuation-token=202835923910178018 --parameters max-keys=2In this example, the listing starts from the throttling configurations of requester ID 202835923910178018 and returns a maximum of 2 entries.