Object Storage Service:PutObjectTagging

Observações de uso

• É possível adicionar até 10 tags a um objeto. As chaves das tags devem ser únicas para cada objeto.

• A chave da tag pode ter no máximo 128 caracteres, enquanto o valor aceita até 256 caracteres.

• Tanto as chaves quanto os valores das tags diferenciam maiúsculas de minúsculas.

• Chaves e valores podem conter letras, dígitos, espaços e os seguintes caracteres especiais:

  + - = . _ : /

  Caso as tags no cabeçalho HTTP contenham caracteres especiais, aplique a codificação URL nas chaves e nos valores.

• Alterar as tags de um objeto não atualiza o parâmetro Last-Modified desse objeto.

Para mais informações sobre tags de objetos, consulte Configure object tagging.

Versionamento

Por padrão, ao chamar PutObjectTagging para adicionar ou atualizar tags, a operação afeta a versão atual do objeto. Para direcionar a ação a uma versão específica, especifique o parâmetro versionId na solicitação. Se a versão indicada for um marcador de exclusão, o OSS retornará 404 Not Found.

Permissões

Uma conta Alibaba Cloud possui permissões completas por padrão. Usuários RAM ou funções RAM vinculados a essa conta não têm permissões atribuídas automaticamente. A conta Alibaba Cloud ou o administrador deve conceder as permissões de operação necessárias por meio de RAM policies ou Bucket Policy.

Sintaxe da solicitação

PUT /objectname?tagging
Content-Length: 114
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue
<Tagging>
  <TagSet>
    <Tag>
      <Key>Key</Key>
      <Value>Value</Value>
    </Tag>
  </TagSet>
</Tagging>            

Elementos da solicitação

Esta operação também utiliza cabeçalhos de solicitação comuns. Para mais informações, consulte Common HTTP headers.

Exemplos

• Adicionar tags a um objeto em um bucket sem versionamento

  Neste exemplo, o objeto chamado objectname está armazenado em um bucket sem versionamento denominado bucketname. Uma solicitação PutObjectTagging adiciona as tags {a:1} e {b:2} ao objeto objectname. Após a adição das duas tags, o sistema retorna 200 (OK).

  Solicitações de exemplo

  PUT /objectname?tagging
  Content-Length: 114
  Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  Date: Mon, 18 Mar 2019 08:25:17 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  <Tagging>
    <TagSet>
      <Tag>
        <Key>a</Key>
        <Value>1</Value>
      </Tag>
      <Tag>
        <Key>b</Key>
        <Value>2</Value>
      </Tag>
    </TagSet>
  </Tagging>

  Respostas de exemplo

  200 (OK)
  content-length: 0
  server: AliyunOSS
  connection: keep-alive
  x-oss-request-id: 5C8F55ED461FB4A64C00****
  date: Mon, 18 Mar 2019 08:25:17 GMT

• Adicionar tags a um objeto em um bucket com versionamento ativado

  Neste exemplo, o objeto chamado objectname está armazenado em um bucket versionado denominado bucketname. Uma solicitação PutObjectTagging adiciona a tag {age:18} à versão especificada do objeto objectname. Após a adição da tag, o sistema retorna 200 (OK).

  Solicitações de exemplo

  PUT /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
  Content-Length: 90
  Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  Date: Wed, 24 Jun 2020 08:58:15 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  <Tagging>
    <TagSet>
      <Tag>
        <Key>age</Key>
        <Value>18</Value>
      </Tag>
    </TagSet>
  </Tagging>

  Respostas de exemplo

  200 (OK)
  content-length: 0
  server: AliyunOSS
  connection: keep-alive
  x-oss-request-id: 5EF315A7FBD3EC3232B4****
  date: Wed, 24 Jun 2020 08:58:15 GMT
  x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****

SDKs do OSS

Use os SDKs do OSS nas linguagens a seguir para chamar a operação PutObjectTagging:

• Java

• Python V2

• Go V2

• PHP V2

• C++

• .NET

• Node.js

• iOS

• Android

ossutil

Para obter informações sobre o comando ossutil correspondente à operação PutObjectTagging, consulte put-object-tagging.

Códigos de erro