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

Notas de uso

Por padrão, uma conta Alibaba Cloud tem as permissões para adicionar ou editar as tags de um objeto. Adicionar e editar tags como usuário RAM ou usando o Security Token Service (STS) requer permissões oss:PutObjectTagging. Para mais informações, consulte Conceder uma política personalizada.
Cada tag adicionada a um objeto é um par chave-valor. Você pode adicionar até 10 tags a um objeto. As tags adicionadas a um objeto devem ter chaves de tag exclusivas. Uma chave de tag pode ter até 128 caracteres. Um valor de tag pode ter até 256 caracteres. Chaves e valores de tag 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: +-=._:/.
Editar 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 na operação PutObjectTagging, consulte PutObjectTagging.

--tagging

A opção de configuração --tagging suporta formatos XML e JSON. Se o valor da opção contiver o prefixo 'file://', os parâmetros de configuração sã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 suportadas, consulte Opções de linha de comando.

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>

Comando de exemplo:

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"
      }
    ]
  }
}

Comando de exemplo:

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

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

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