資源組是一種基于資源的權限管理方式。您可以將需要授予同樣權限的Bucket歸為同一個資源組,然后統一為該資源組授權,從而提升授權效率。本文介紹如何調用PutBucketResourceGroup接口為Bucket配置所屬資源組。
注意事項
阿里云賬號默認擁有為Bucket配置所屬資源組的權限。如果您希望通過RAM用戶或者STS的方式為Bucket配置所屬資源組,您必須擁有oss:PutBucketResourceGroup
權限。具體操作,請參見為RAM用戶授權自定義的權限策略。
請求語法
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
錯誤碼
錯誤碼 | HTTP狀態碼 | 描述 |
AccessDenied | 403 | 返回該錯誤的可能原因如下:
|
ResourceGroupIdPreCheckError | 400 | 設置的資源組ID不合法或不存在,資源組ID預檢查失敗。 |
文檔內容是否對您有幫助?