文档

put-bucket-resource-group

更新时间:

put-bucket-resource-group用于配置存储空间(Bucket)所属的资源组ID。

注意事项

阿里云账号默认拥有配置Bucket所属的资源组ID的权限。如果您需要通过RAM用户或者STS的方式进行配置,您必须拥有oss:PutBucketResourceGroup权限。具体操作,请参见为RAM用户授权自定义的权限策略

命令格式

ossutil api put-bucket-resource-group --bucket value [flags]

参数

类型

说明

--bucket

string

要修改的目标Bucket。

--resource-group-configuration

string

配置资源组ID的容器。

说明

put-bucket-resource-group命令对应API接口PutBucketResourceGroup。关于API中的具体参数含义,请参见PutBucketResourceGroup

--resource-group-configuration

--resource-group-configuration配置选项既支持XML语法也支持JSON语法,当选项值包含file://前缀时,表示从文件中读取配置。

  • XML语法:

    <BucketResourceGroupConfiguration>
      <ResourceGroupId>string</ResourceGroupId>
    </BucketResourceGroupConfiguration>
  • JSON语法:

    {
      "ResourceGroupId": "string"
    }
说明

关于支持的全局命令行选项,请参见支持的全局命令行选项

使用示例

以下示例展示了如何配置存储空间examplebucket资源组ID为rg-123

  • 使用XML配置文件,resource-group-configuration.xml内容如下:

    <?xml version="1.0" encoding="UTF-8"?>
    <BucketResourceGroupConfiguration>
      <ResourceGroupId>rg-123</ResourceGroupId>
    </BucketResourceGroupConfiguration>

命令示例如下:

ossutil api put-bucket-resource-group --bucket examplebucket --resource-group-configuration file://resource-group-configuration.xml
  • 使用JSON配置文件,antiddos-configuration.json 内容如下:

    {
      "ResourceGroupId": "rg-123"
    }

    命令示例如下:

    ossutil api put-bucket-resource-group --bucket examplebucket --resource-group-configuration file://resource-group-configuration.json
  • 使用JSON配置参数,命令示例如下:

    ossutil api put-bucket-resource-group --bucket examplebucket --resource-group-configuration "{\"ResourceGroupId\":\"rg-123\"}"