资源组是一种基于资源的权限管理方式。您可以将需要授予同样权限的Bucket归为同一个资源组,然后统一为该资源组授权,从而提升授权效率。本文介绍如何调用PutBucketResourceGroup接口为Bucket配置所属资源组。
权限说明
阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限,需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。
API | Action | 说明 |
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预检查失败。 |