put-object-tagging - Object Storage Service: Central de Documentação do Alibaba Cloud

Notas de uso

Por padrão, uma conta Alibaba Cloud tem permissões para adicionar ou editar as tags de um objeto. Para adicionar e editar tags como usuário RAM ou por meio do Security Token Service (STS), é necessário ter a permissão oss:PutObjectTagging. Para mais informações, consulte Grant a custom policy.
Cada tag adicionada a um objeto é um par chave-valor. É possível adicionar até 10 tags a um objeto, e todas 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 são sensíveis a maiúsculas e minúsculas. Tanto a chave quanto o valor de uma tag podem conter letras, dígitos, espaços e os seguintes caracteres especiais: +-=._:/.
Editar as tags de um objeto não atualiza o parâmetro Last-Modified do objeto.

Sintaxe do comando

ossutil api put-object-tagging --bucket value --key value --tagging value [flags]

Parâmetro	Tipo	Descrição
--bucket	string	Nome do bucket.
--key	string	Caminho completo do objeto.
--tagging	string	Tags.
--version-id	string	ID da versão do objeto.

Nota

O comando put-object-tagging corresponde à operação PutObjectTagging. Para mais informações sobre os parâmetros da operação PutObjectTagging, consulte PutObjectTagging.

--tagging

A opção de configuração --tagging aceita os formatos XML e JSON. Se o valor da opção contiver o prefixo file://, os parâmetros de configuração serão lidos do arquivo especificado.

Formato XML:

<Tagging>
  <TagSet>
    <Tag>
      <Key>string</Key>
      <Value>string</Value>
    </Tag>
    ...
  </TagSet>
</Tagging>

Formato JSON:

{
  "TagSet": {
    "Tag": [
      {
        "Key": "string",
        "Value": "string"
      },
      ...
    ]
  }
}

Nota

Para mais informações sobre as opções globais de linha de comando disponíveis, consulte Command-line options.

Exemplos

Adicione ou edite tags para exampleobject.

Crie um arquivo de configuração chamado tagging.xml e adicione o seguinte código:

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

Exemplo de comando:

ossutil api put-object-tagging --bucket examplebucket --key exampleobject --tagging file://tagging.xml

Crie um arquivo de configuração chamado tagging.json e adicione o seguinte código:

{
  "TagSet": {
    "Tag": [
      {
        "Key": "key1",
        "Value": "value1"
      },
      {
        "Key": "key2",
        "Value": "value2"
      }
    ]
  }
}

Exemplo de comando:

ossutil api put-object-tagging --bucket examplebucket --key exampleobject --tagging file://tagging.json

Configure os parâmetros diretamente no formato JSON pelo seguinte comando:

ossutil api put-object-tagging --bucket examplebucket --key exampleobject --tagging "{\"TagSet\":{\"Tag\":[{\"Key\":\"key1\",\"Value\":\"value1\"},{\"Key\":\"key2\",\"Value\":\"value2\"}]}}"