All Products
Search
Document Center

Object Storage Service:get-bucket-qos-info

Last Updated:Mar 20, 2026

Queries the Quality of Service (QoS) configurations for a bucket.

Usage notes

Important

The resource pool QoS feature is in invitational preview. To apply, your OSS throughput in a specific region must be at least 500 Gbit/s. Contact technical support to request access.

  • Alibaba Cloud accounts can query QoS configurations by default. RAM users and Security Token Service (STS) credentials require the oss:GetBucketQoSInfo permission. For details, see Common examples of RAM policies.

  • A value of -1 means no limit is applied to that field. If a field is absent from the response, the default is -1. A value of 0 means that type of access request is blocked.

Syntax

ossutil api invoke-operation --op-name get-bucket-qos-info --method GET --bucket <bucket-name> --parameters qosInfo
ParameterTypeDescription
--bucketstringName of the bucket.
--parametersstringArrayRequest parameters in key[=value] format, such as versionId=123 or delete.
Note

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

Example

The following command queries the QoS configurations for examplebucket:

ossutil api invoke-operation --op-name get-bucket-qos-info --method GET --bucket examplebucket --parameters qosInfo