調用PutBucketResourceGroup介面為Bucket配置所屬資源群組 - Object Storage Service

資源群組是一種基於資源的許可權管理方式。您可以將需要授予同樣許可權的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: Thu, 17 Apr 2025 01:33:47 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218
<?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預檢查失敗。