Object Storage Service:PutObjectTagging

Notas de uso

• É possível adicionar até 10 tags a um objeto. As tags adicionadas a um objeto devem ter chaves únicas.

• Uma chave de tag pode ter até 128 caracteres. Um valor de tag pode ter até 256 caracteres.

• Chaves e valores de tags diferenciam maiúsculas de minúsculas.

• A chave e o valor de uma tag podem conter letras, dígitos, espaços e os seguintes caracteres especiais:

  + - = . _ : /

  Se as tags do cabeçalho HTTP contiverem caracteres especiais, aplique a codificação URL nas chaves e nos valores das tags.

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

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

Versionamento

Por padrão, ao chamar PutObjectTagging para adicionar ou atualize tags de um objeto, as tags são aplicadas à versão atual do objeto. Especifique o parâmetro versionId na requisição para adicionar ou atualize tags de uma versão específica do objeto. Se a versão especificada for um marcador de exclusão, o OSS retorna 404 Not Found.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões completas. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm 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.

Sintaxe da requisiçã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 requisição

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

Exemplos

• Adicionar tags a um objeto em um bucket sem versionamento

  Neste exemplo, um objeto chamado objectname está armazenado em um bucket sem versionamento chamado bucketname. Uma requisição PutObjectTagging é enviada para adicionar as tags {a:1} e {b:2} ao objeto objectname. Após a adição das duas tags, o código 200 (OK) é retornado.

  Sample requests

  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>

  Sample responses

  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, um objeto chamado objectname está armazenado em um bucket com versionamento chamado bucketname. Uma requisição PutObjectTagging é enviada para adicionar a tag {age:18} à versão especificada de objectname. Após a adição da tag, o código 200 (OK) é retornado.

  Sample requests

  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>

  Sample responses

  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****

OSS SDKs

Use os OSS SDKs para as seguintes linguagens de programação ao chamar a operação PutObjectTagging:

• Java

• Python V2

• Go V2

• PHP V2

• C++

• .NET

• Node.js

• iOS

• Android

ossutil

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

Códigos de erro