All Products
Search
Document Center

Object Storage Service:list-resource-pool-buckets

Last Updated:Mar 20, 2026

Lists the buckets within a specific resource pool.

Usage notes

Important

Resource pool quality of service (QoS) is in invitational preview. If the throughput of your Object Storage Service (OSS) buckets in a specific region is greater than or equal to 500 Gbit/s, contact technical support to apply for this feature.

By default, an Alibaba Cloud account has permission to list resource pool information. To perform this operation as a RAM user or by using Security Token Service (STS), grant the oss:ListResourcePoolBuckets permission. For more information, see Attach a custom policy to a RAM user.

Syntax

ossutil api invoke-operation --op-name list-resource-pool-buckets --method GET --parameters resourcePool=<resource-pool> --parameters resourcePoolBuckets [--parameters continuation-token=<continuation-token>] [--parameters max-keys=<max-keys>]
ParameterTypeDescription
--parametersstringArrayRequest parameters in the k[=v] format, for example, max-keys=10 and delete.
Note

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

Example

The following command lists buckets in examplePool, starting from the bucket named examplebucket. The maximum number of entries returned is set to 10.

ossutil api invoke-operation --op-name list-resource-pool-buckets --method GET --parameters resourcePool=examplePool --parameters resourcePoolBuckets --parameters continuation-token=examplebucket --parameters max-keys=10