Object Storage Service:put-bucket-tags

Notas de uso

• Por padrão, uma conta alibaba cloud tem as permissões para adicionar tags a um bucket ou modifique as tags existentes. Para adicionar ou modifique as tags de um bucket usando um usuário RAM ou o Security Token service (STS), você precisa ter a permissão oss:PutBucketTags. Para mais informações, consulte Attach a custom policy to a RAM user.

• Execute o comando put-bucket-tags para adicionar tags a um bucket. As novas tags substituirão as tags existentes.

• Você pode configure até 20 tags para um bucket. Cada tag é um par chave-valor.

Sintaxe do comando

ossutil api put-bucket-tags --bucket value --tagging value [flags]

--tagging

A opção --tagging aceita os formatos XML e JSON. Se o valor da opção contiver o prefixo file://, o ossutil lê as configurações de um arquivo de configuração.

• Formato XML:

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

• Formato JSON:

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

Exemplos

Os exemplos a seguir mostram como adicionar tags a um bucket chamado examplebucket ou modifique as tags existentes.

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

  <?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-bucket-tags --bucket examplebucket --tagging file://tagging.xml

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

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

  Comando de exemplo:

  ossutil api put-bucket-tags --bucket examplebucket --tagging file://tagging.json

• Configure os parâmetros no comando a seguir usando o formato JSON:

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