Todos os produtos
Search
Central de documentação

Object Storage Service:PutBucketResourceGroup

Última atualização: Sep 22, 2026

Use grupos de recursos para gerencie recursos. Agrupe os buckets aos quais deseja conceder as mesmas permissões em um mesmo grupo de recursos e, em seguida, conceda permissões ao grupo. Isso aumenta a eficiência da autorização. Este tópico descreve como chamar a operação PutBucketResourceGroup para configure o grupo de recursos ao qual um bucket pertence.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. RAM users ou RAM roles sob uma conta Alibaba Cloud não possuem nenhuma permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder permissões de operação por meio de RAM policies ou Bucket Policy.

API

Action

Description

PutBucketResourceGroup

oss:PutBucketResourceGroup

Configura um grupo de recursos para um bucket.

Sintaxe da requisição

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>

Cabeçalhos da requisição

Uma requisição PutBucketResourceGroup usa apenas cabeçalhos de requisição comuns. Para mais informações, consulte Common request headers.

Elementos da requisição

Elemento

Tipo

Obrigatório

Exemplo

Descrição

BucketResourceGroupConfiguration

Container

Sim

N/D

O container que armazena o ID do grupo de recursos.

Nós filhos: ResourceGroupId

ResourceGroupId

String

Sim

rg-aekz****

O ID do grupo de recursos ao qual o bucket pertence.

Se este elemento não for especificado, o bucket será movido para o grupo de recursos padrão.

Nó pai: BucketResourceGroupConfiguration

Cabeçalhos da resposta

A resposta a uma requisição PutBucketResourceGroup contém apenas cabeçalhos de resposta comuns. Para mais informações, consulte Common response headers.

Exemplos

Exemplo de requisição

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>

Exemplo de resposta com sucesso

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 SDKs

Use os OSS SDKs das seguintes linguagens de programação para chamar PutBucketResourceGroup:

ossutil

Para informações sobre o comando ossutil correspondente à operação PutBucketResourceGroup, consulte put-bucket-resource-group.

Códigos de erro

Código de erro

Código de status HTTP

Descrição

AccessDenied

403

Causas possíveis:

  • Você não incluiu as informações de autenticação do usuário ao iniciar a requisição.

  • Você não tem as permissões necessárias para executar a operação.

ResourceGroupIdPreCheckError

400

O ID do grupo de recursos especificado é inválido ou não existe. O ID do grupo de recursos falhou na verificação prévia.