All Products
Search
Document Center

Object Storage Service:list-resource-pools

Last Updated:Mar 19, 2026

Lists the resource pools associated with the Alibaba Cloud account in the current region.

Important

Resource pool quality of service (QoS) is in invitational preview. If the throughput of 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.

Prerequisites

Before you begin, ensure that you have:

  • An Alibaba Cloud account (which has the permission to list resource pools by default), or a RAM user or Security Token Service (STS) identity with the oss:ListResourcePools permission. For details, see Attach a custom policy to a RAM user.

  • Configured the ossutil endpoint to the region where the resource pools reside. Resource pools are region-specific — only pools within the region mapped to the endpoint are returned.

Syntax

ossutil api invoke-operation --op-name list-resource-pools --method GET --parameters resourcePool [--parameters continuation-token=<continuation-token>] [--parameters max-keys=<max-keys>]
ParameterTypeDescription
--parametersstringArrayRequest parameters in the k[=v] format, such as versionId=123 and delete.
Note

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

Examples

List all resource pools associated with the current Alibaba Cloud account:

ossutil api invoke-operation --op-name list-resource-pools --method GET --parameters resourcePool

Start listing from examplebucket and return a maximum of 1 entry:

ossutil api invoke-operation --op-name list-resource-pools --method GET --parameters resourcePool --parameters continuation-token=examplebucket --parameters max-keys=1