Tous les produits
Search
Centre de documentation

Object Storage Service:PutBucketResourceGroup

Dernière mise à jour :Aug 10, 2026

Les groupes de ressources permettent d'organiser et de gérer vos ressources. Regroupez les buckets nécessitant les mêmes autorisations au sein d'un même groupe de ressources, puis accordez ces autorisations directement au groupe. Cette approche optimise la gestion des accès. Cette rubrique explique comment appeler l'opération PutBucketResourceGroup pour configurer le groupe de ressources auquel appartient un bucket.

Autorisations

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'exploitation via des politiques RAM ou une Bucket Policy.

API

Action

Description

PutBucketResourceGroup

oss:PutBucketResourceGroup

Configure un groupe de ressources pour un bucket.

Syntaxe de la requête

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>

En-têtes de requête

La requête PutBucketResourceGroup utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes de requête communs.

Éléments de requête

Élément

Type

Obligatoire

Exemple

Description

BucketResourceGroupConfiguration

Conteneur

Oui

S.O.

Conteneur qui stocke l'ID du groupe de ressources.

Nœuds enfants : ResourceGroupId

ResourceGroupId

Chaîne

Oui

rg-aekz****

ID du groupe de ressources auquel appartient le bucket.

Si cet élément n'est pas spécifié, le bucket est déplacé vers le groupe de ressources par défaut.

Nœuds parents : BucketResourceGroupConfiguration

En-têtes de réponse

La réponse à une requête PutBucketResourceGroup contient uniquement les en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes de réponse communs.

Exemples

Exemple de requête

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>

Exemple de réponse réussie

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 OSS

Utilisez les SDK OSS pour les langages de programmation suivants afin d'appeler l'opération PutBucketResourceGroup :

ossutil

Pour obtenir des informations sur la commande ossutil correspondant à l'opération PutBucketResourceGroup, consultez la page put-bucket-resource-group.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

AccessDenied

403

Causes possibles :

  • Les informations d'authentification de l'utilisateur ne sont pas incluses lors de l'envoi de la requête.

  • Vous ne disposez pas des autorisations nécessaires pour effectuer l'opération.

ResourceGroupIdPreCheckError

400

L'ID du groupe de ressources spécifié n'est pas valide ou n'existe pas. La vérification préalable de l'ID du groupe de ressources a échoué.