Lists the buckets within a specific resource pool.
Notes
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 permissions to list information about a resource pool. Listing information as a RAM user or by using Security Token Service (STS) requires 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>]Parameter | Type | Description |
--parameters | stringArray | Request parameters in the k[=v] format, such as max-keys=10 and delete. |
For information about supported global command-line options, see Global command-line options.
Example
Below is a code example for listing the buckets within 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