All Products
Search
Document Center

Object Storage Service:list-resource-pools

Last Updated:Nov 11, 2025

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

Notes

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.

  • By default, an Alibaba Cloud account has the permission to list resource pools. Listing resource pools as a RAM user or using Security Token Service (STS) requires the oss:ListResourcePools permission. For detailed instructions, see Attach a custom policy to a RAM user.

  • Resource pools are region-specific. You can only list the resource pools within the region mapped to the endpoint.

Syntax

ossutil api invoke-operation --op-name list-resource-pools --method GET --parameters resourcePool [--parameters continuation-token=<continuation-token>] [--parameters max-keys=<max-keys>]

Parameter

Type

Description

--parameters

stringArray

Request parameters in the k[=v] format, such as versionId=123 and delete.

Note

For more information about supported global command-line options, see Command-line options.

Examples

  • List all available resource pools associated with the current Alibaba Cloud account.

    ossutil api invoke-operation --op-name list-resource-pools --method GET --parameters resourcePool
  • Retrieve data starting from examplebucket and set the maximum number of entries returned to 1.

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