すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:PutBucketResourceGroup

最終更新日:Jun 09, 2025

リソースグループを使用してリソースを管理できます。 同じ権限を付与するバケットを同じリソースグループにグループ化し、そのリソースグループに権限を付与できます。 これにより、権限付与の効率が向上します。 このトピックでは、PutBucketResourceGroup 操作を呼び出して、バケットが属するリソースグループを設定する方法について説明します。

権限

デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。 デフォルトでは、Alibaba Cloud アカウントの RAM ユーザーまたは RAM ロールには権限がありません。 Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを使用して操作権限を付与する必要があります。

API

アクション

定義

PutBucketResourceGroup

oss: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 の事前チェックに失敗しました。