get-bucket-requester-qos-info

更新时间:
复制 MD 格式

Queries the throttling configurations that apply to a requester's access to a bucket.

Important

Resource pool quality of service (QoS) is in invitational preview. To apply for this feature, your OSS buckets in a specific region must have a throughput of 500 Gbit/s or higher. Contact technical support to apply.

Prerequisites

Before you begin, ensure that you have the oss:GetBucketRequesterQoSInfo permission, if making requests as a RAM user or using Security Token Service (STS).

Permissions by identity type:

IdentityPermission required
Alibaba Cloud accountNone — access is granted by default
RAM useross:GetBucketRequesterQoSInfo in a custom policy
STSoss:GetBucketRequesterQoSInfo in a custom policy

For instructions on attaching a custom policy to a RAM user, see Attach a custom policy to a RAM user.

Syntax

ossutil api invoke-operation --op-name get-bucket-requester-qos-info --method GET --bucket=<bucket-name> --parameters requesterQosInfo --parameters qosRequester=<uid>

Parameters

ParameterTypeDescription
--bucketstringName of the bucket
--parametersstringArrayRequest parameters in the k[=v] format, such as versionId=123 and delete
Note

For supported global command-line options, see Command-line options.

Example

Query the throttling configurations for requester 202835923910178019 on examplebucket:

ossutil api invoke-operation --op-name get-bucket-requester-qos-info --method GET --bucket=examplebucket --parameters requesterQosInfo --parameters qosRequester=202835923910178019