Execute o comando object-tagging para gerenciar tags de objetos - Object Storage Service: Central de Documentação do Alibaba Cloud

O Object Storage Service (OSS) permite usar tags para classificar objetos. É possível gerenciar objetos com a mesma tag. Por exemplo, especifique o período de validade ou converta a classe de armazenamento de objetos que compartilham a mesma tag. Execute o comando object-tagging para adicionar, modifique, consultar ou exclua tags de objetos.

Observações de uso

Para adicionar ou modifique uma tag de objeto, você precisa da permissão oss:PutObjectTagging. Para consultar tags de objetos, é necessária a permissão oss:GetObjectTagging. Já para exclua uma tag de objeto, utilize a permissão oss:DeleteObjectTagging. Para mais informações, consulte Conceder uma política personalizada.

No ossutil 1.6.16 e versões posteriores, use diretamente ossutil como nome do binário na linha de comando. Não é preciso alterar o nome do binário conforme o sistema operacional. Em versões anteriores à 1.6.16, atualize o nome do binário de acordo com o sistema operacional. Para mais informações, consulte Guia de início rápido da ferramenta de linha de comando ossutil.
Para mais detalhes sobre tags de objetos, consulte Marcar objetos com tags.

Sintaxe do comando

ossutil object-tagging oss://bucketname[/prefix][key#value]
--method <value>
[--encoding-type <value>]
[-r, --recursive]
[--payer <value>]
[--version-id <value>]

A tabela a seguir descreve os parâmetros e opções da sintaxe.

Parâmetro/Opção	Descrição
bucketname	Nome do bucket.
prefix	Prefixo nos nomes dos recursos, como pastas e objetos.
key	Chave da tag. Uma tag é um par chave-valor. Cada objeto aceita até 10 tags. As tags do mesmo objeto devem ter chaves exclusivas. A chave da tag deve atender aos seguintes requisitos: A chave da tag tem no máximo 128 caracteres e diferencia maiúsculas de minúsculas. A chave da tag pode conter letras, dígitos, espaços e os seguintes caracteres especiais: +=._:/
value	Valor da tag. O valor da tag deve atender aos seguintes requisitos: O valor da tag tem no máximo 256 caracteres e diferencia maiúsculas de minúsculas. O valor da tag pode conter letras, dígitos, espaços e os seguintes caracteres especiais: +=._:/
--method	Tipo da solicitação. Valores válidos: put: adiciona tags a um objeto ou modifique as tags existentes. get: consulta as tags de um objeto. delete: exclua as tags de um objeto.
--encoding-type	Método usado para codificar o prefixo após `oss://bucket_name`. Valor válido: url. Se esta opção não for especificada, o prefixo não será codificado.
-r, --recursive	Se esta opção for incluída no comando, o ossutil configure tags para todos os objetos cujos nomes contenham o prefixo especificado pelo parâmetro prefix. Caso contrário, o ossutil configure tags apenas para o objeto especificado.
--version-id	ID da versão do objeto. Este parâmetro se aplica somente a buckets com versionamento ativado ou suspenso.
--payer	Pagador da solicitação. Para que o solicitante que acessa os recursos no caminho especificado pague as taxas geradas pela operação, como tráfego e solicitações, defina este parâmetro como requester.

Adicionar ou modifique tags de objetos

Somente o proprietário do bucket e usuários RAM com a permissão PutObjectTagging podem adicionar ou modifique tags de objetos no bucket.

Os exemplos a seguir mostram como adicionar e modifique tags de um objeto:

Importante

Se o objeto especificado não tiver uma tag com a mesma chave informada no comando, a tag será adicionada ao objeto. Se já existir uma tag com a mesma chave, ela será sobrescrita.

Execute o comando abaixo para configure uma tag com chave tagkey e valor tagvalue em um objeto chamado exampleobject.txt, armazenado no bucket examplebucket:
```
ossutil object-tagging --method put oss://examplebucket/exampleobject.txt tagkey#tagvalue
```
Use o seguinte comando para definir as tags tagkey1#tagvalue1 e tagkey2#tagvalue2 no objeto exampleobject.png dentro do bucket examplebucket:
```
ossutil object-tagging --method put oss://examplebucket/exampleobject.txt tagkey1#tagvalue1 tagkey2#tagvalue2
```
Para aplicar as tags tagkey3#tagvalue3, tagkey4#tagvalue4 e tagkey5#tagvalue5 a todos os objetos com o prefixo "test" no bucket examplebucket, execute:
```
ossutil object-tagging --method put oss://examplebucket/test -r tagkey3#tagvalue3 tagkey4#tagvalue4 tagkey5#tagvalue5
```
Configure uma tag com chave tagkey6 e valor tagvalue6 para uma versão específica do objeto exampleobject.txt no bucket examplebucket usando o comando:
```
ossutil object-tagging --method put oss://examplebucket/exampleobject.txt tagkey6#tagvalue6 --version-id CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3****
```
Para mais informações sobre como listar todas as versões de um objeto, consulte ls (Listar buckets, objetos ou partes).
Após a execução bem-sucedida dos comandos acima, uma saída semelhante à seguinte será retornada, indicando o tempo gasto na configuração das tags:
```
0.106852(s) elapsed
```

Consultar tags de objetos

Apenas o proprietário do bucket e usuários RAM com a permissão GetObjectTagging podem consultar as tags dos objetos no bucket.

Veja a seguir exemplos de consulta de tags de objetos:

Consultar tags de um único objeto

Para verificar as tags do objeto exampleobject.txt no bucket examplebucket, execute:

ossutil object-tagging --method get oss://examplebucket/exampleobject.txt

A saída abaixo indica que exampleobject.txt possui uma tag com chave tagkey e valor tagvalue.

object index   tag index      tag key   tag value       object
---------------------------------------------------------------------------
1              0              "tagkey"  "tagvalue"      oss://examplebucket/exampleobject.txt

0.068156(s) elapsed

Consultar tags de vários objetos

Liste as tags de todos os objetos com o prefixo "test" no bucket examplebucket executando:

ossutil object-tagging --method get oss://examplebucket/test -r

O resultado mostra que os objetos com o prefixo "test" possuem as tags: tagkey3#tagvalue3, tagkey4#tagvalue4 e tagkey5#tagvalue5.

object index   tag index      tag key   tag value       object
---------------------------------------------------------------------------
1              0              "tagkey3" "tagvalue3"     oss://examplebucket/test
1              1              "tagkey4" "tagvalue4"     oss://examplebucket/test
1              2              "tagkey5" "tagvalue5"     oss://examplebucket/test

0.093040(s) elapsed

Exclua tags de objetos

Somente o proprietário do bucket e usuários RAM com a permissão DeleteObjectTagging podem exclua tags de objetos no bucket.

Os exemplos a seguir demonstram como exclua tags de objetos:

Exclua tags de um único objeto

Remova as tags do objeto exampleobject.txt no bucket examplebucket com o comando:
```
ossutil object-tagging --method delete oss://examplebucket/exampleobject.txt
```
Exclua tags de múltiplos objetos

Para remover as tags de todos os objetos com o prefixo "test" no bucket examplebucket, utilize:
```
ossutil object-tagging --method delete oss://examplebucket/test -r
```
Se os comandos forem executados com êxito, uma saída similar à seguinte indicará o tempo decorrido na exclusão das tags:
```
0.148970(s) elapsed
```

Opções comuns

Para acessar um bucket em outra região, use -e para especifique o endpoint. Para acessar um bucket pertencente a outra conta Alibaba Cloud, utilize -i para o AccessKey ID e -k para o AccessKey secret.

Por exemplo, para configure uma tag com chave tagkey7 e valor tagvalue7 no objeto example.png dentro do bucket testbucket, localizado na região China (Shanghai) e pertencente a outra conta Alibaba Cloud, execute:

ossutil object-tagging --method put oss://testbucket/exampletest.png tagkey7#tagvalue7 -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Opções comuns.