Put-bucket-resource-pool-bucket-group-Object Storage Service(OSS)-阿里云帮助中心

The put-bucket-resource-pool-bucket-group command assigns a bucket in a resource pool to a bucket group, or removes it from one.

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 the feature.

Prerequisites

Before you begin, ensure that you have:

A bucket that already belongs to a resource pool. Adding a bucket that is not part of a resource pool is not supported.
The oss:PutBucketResourcePoolBucketGroup permission if using a Resource Access Management (RAM) user or Security Token Service (STS). Alibaba Cloud accounts have this permission by default. For more information, see Grant custom permissions to a RAM user.

Syntax

ossutil api invoke-operation \
    --op-name put-bucket-resource-pool-bucket-group \
    --method PUT \
    --bucket <BucketName> \
    --parameters resourcePool=<ResourcePoolName> \
    --parameters resourcePoolBucketGroup=<ResourcePoolBucketGroup>

Parameters

Parameter	Type	Required	Description
`--parameters resourcePool`	string	Yes	The name of the resource pool that the bucket belongs to.
`--parameters resourcePoolBucketGroup`	string	Yes	The name of the bucket group to assign the bucket to. To remove the bucket from its current bucket group, set this value to blank (`resourcePoolBucketGroup=`).
`--parameters`	stringArray	—	Request parameters in `k[=v]` format. Used to pass both `resourcePool` and `resourcePoolBucketGroup` values as shown above.

Note

For global command options, see Supported global command options.

Examples

Assign a bucket to a bucket group

The following command assigns examplebucket to exampleGroup in examplePool:

ossutil api invoke-operation \
    --op-name put-bucket-resource-pool-bucket-group \
    --method PUT \
    --bucket examplebucket \
    --parameters resourcePool=examplePool \
    --parameters resourcePoolBucketGroup=exampleGroup

Remove a bucket from a bucket group

The following command removes examplebucket from its current bucket group in examplePool by setting resourcePoolBucketGroup to blank:

ossutil api invoke-operation \
    --op-name put-bucket-resource-pool-bucket-group \
    --method PUT \
    --bucket examplebucket \
    --parameters resourcePool=examplePool \
    --parameters resourcePoolBucketGroup=