调用PutBucketResourceGroup接口为Bucket配置所属资源组

资源组是一种基于资源的权限管理方式。您可以将需要授予同样权限的Bucket归为同一个资源组，然后统一为该资源组授权，从而提升授权效率。本文介绍如何调用PutBucketResourceGroup接口为Bucket配置所属资源组。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。

API	Action	说明
PutBucketResourceGroup	`oss:PutBucketResourceGroup`	为Bucket配置所属资源组。

请求语法

PUT /?resourceGroup
Date: GMT Date
Content-Length：ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<BucketResourceGroupConfiguration>
  <ResourceGroupId>rg-aekz****</ResourceGroupId>
</BucketResourceGroupConfiguration>

请求头

此接口仅包含公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求元素

名称

类型

是否必选

示例值

描述

BucketResourceGroupConfiguration

容器

是

不涉及

配置资源组ID的容器。

子节点：ResourceGroupId

ResourceGroupId

字符串

是

rg-aekz****

Bucket所属的资源组ID。

如果此项值设置为空，则表示移动Bucket到默认资源组。

父节点：BucketResourceGroupConfiguration

响应头

此接口仅包含公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

示例

请求示例

PUT /?resourceGroup
Content-Length: 0
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Sat, 8 May 2021 01:33:47 GMT
Authorization: OSS qn6q**************:77Dv****************
<?xml version="1.0" encoding="UTF-8"?>
<BucketResourceGroupConfiguration>
  <ResourceGroupId>rg-aekz****</ResourceGroupId>
</BucketResourceGroupConfiguration>

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 5D3663FBB007B79097FC****
Date: Sat, 8 May 2021 01:33:47 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

SDK

本接口对应的各语言SDK如下：

命令行工具ossutil

PutBucketResourceGroup接口所对应的ossutil命令，请参见put-bucket-resource-group。

错误码

错误码

HTTP状态码

描述

AccessDenied

403

返回该错误的可能原因如下：

发起请求时未传入用户验证信息。
没有操作权限。

ResourceGroupIdPreCheckError

400

设置的资源组ID不合法或不存在，资源组ID预检查失败。