All Products
Search
Document Center

Object Storage Service:list-resource-pools

Last Updated:Oct 29, 2026

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

Notes

Important

Resource pool QoS is in invitational preview. If the throughput of your OSS buckets in a region has reached or exceeded 400 Gbit/s, you can 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 Grant a custom policy.

  • 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