PutBucketTags - Adicionar ou modificar tags de bucket - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações de uso

Ao chamar a operação PutBucketTags, observe o seguinte:

Somente o proprietário do bucket e usuários RAM autorizados podem configure tags de bucket. Outros usuários recebem um erro 403 Forbidden com o código de erro AccessDenied.
Cada bucket aceita até 20 tags (pares chave-valor).
A operação PutBucketTags usa semântica de sobrescrita: uma nova tag substitui qualquer tag existente com a mesma chave.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.

Sintaxe da solicitação

PUT /?tagging HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Authorization: SignatureValue
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>key1</Key>
      <Value>value1</Value>
    </Tag>
    <Tag>
      <Key>key2</Key>
      <Value>value2</Value>
    </Tag>
  </TagSet>
</Tagging>

Cabeçalhos da solicitação

Esta solicitação usa apenas cabeçalhos comuns. Para mais informações, consulte Cabeçalhos comuns de solicitação.

Elementos da solicitação

Elemento	Tipo	Obrigatório	Descrição
Tagging	Contêiner	Sim	Contêiner para TagSet. Nós filhos: TagSet Nós pais: nenhum
TagSet	Contêiner	Sim	Contêiner para tags. Nós filhos: Tag Nós pais: Tagging
Tag	Contêiner	Sim	Contêiner da tag a adicionar ou modifique. Nós filhos: Key e Value Nós pais: TagSet
Key	STRING	Sim	Chave da tag. Comprimento máximo: 64 bytes. A chave da tag não pode começar com `http://`, `https://` ou `Aliyun`. Codificação UTF-8 obrigatória. Não pode estar vazia. Nós filhos: nenhum Nós pais: Tag
Value	STRING	Não	Valor da tag. Comprimento máximo: 128 bytes. Codificação UTF-8 obrigatória. Pode estar vazio. Nós filhos: nenhum Nós pais: Tag

Cabeçalhos da resposta

Esta resposta usa apenas cabeçalhos comuns. Para mais informações, consulte Cabeçalhos comuns de resposta.

Exemplos

Exemplo de solicitação

PUT /?tagging
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 11:49:13 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<Tagging>
  <TagSet>
    <Tag>
      <Key>testa</Key>
      <Value>testv1</Value>
    </Tag>
    <Tag>
      <Key>testb</Key>
      <Value>testv2</Value>
    </Tag>
  </TagSet>
</Tagging>

Exemplo de resposta

200 (OK)
content-length: 0
server: AliyunOSS
x-oss-request-id: 5C1B138A109F4E405B2D****
date: Thu, 20 Dec 2018 11:59:06 GMT
x-oss-server-time: 148
connection: keep-alive

SDKs do OSS

Use os SDKs do OSS nas seguintes linguagens para chamar a operação PutBucketTags:

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação PutBucketTags, consulte put-bucket-tags.

API	Action	Descrição
PutBucketTags	oss:PutBucketTagging	Adiciona tags a um bucket ou modifique as tags existentes.