リソースグループを使用してリソースを管理できます。 同じ権限を付与するバケットを同じリソースグループにグループ化し、そのリソースグループに権限を付与できます。 これにより、権限付与の効率が向上します。 このトピックでは、PutBucketResourceGroup 操作を呼び出して、バケットが属するリソースグループを設定する方法について説明します。
権限
デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。 デフォルトでは、Alibaba Cloud アカウントの RAM ユーザーまたは RAM ロールには権限がありません。 Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを使用して操作権限を付与する必要があります。
API | アクション | 定義 |
PutBucketResourceGroup |
| バケットのリソースグループを設定します。 |
リクエスト構文
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>
リクエストヘッダー
PutBucketResourceGroup リクエストのリクエストヘッダーは、共通のリクエストヘッダーのみです。 詳細については、「共通リクエストヘッダー」をご参照ください。
リクエスト要素
要素 | タイプ | 必須 | 例 | 説明 |
BucketResourceGroupConfiguration | コンテナー | はい | 該当なし | リソースグループ ID を格納するコンテナー。 子ノード: ResourceGroupId |
ResourceGroupId | 文字列 | はい | rg-aekz**** | バケットが属するリソースグループの ID。 この要素が指定されていない場合、バケットはデフォルトのリソースグループに移動されます。 親ノード: BucketResourceGroupConfiguration |
レスポンスヘッダー
PutBucketResourceGroup リクエストへのレスポンスには、共通のレスポンスヘッダーのみが含まれます。 詳細については、「共通レスポンスヘッダー」をご参照ください。
例
リクエストの例
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
OSS SDK
以下のプログラミング言語の OSS SDK を使用して、PutBucketResourceGroup を呼び出すことができます。
ossutil
PutBucketResourceGroup 操作に対応する ossutil コマンドについては、「put-bucket-resource-group」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
AccessDenied | 403 | 考えられる原因:
|
ResourceGroupIdPreCheckError | 400 | 指定されたリソースグループの ID が無効であるか、存在しません。 リソースグループの ID の事前チェックに失敗しました。 |