Object Storage Service:bucket-tagging

Observações

• Para adicionar ou modifique tags de bucket, você precisa da permissão oss:PutBucketTagging. Para consultar tags de bucket, é necessária a permissão oss:GetBucketTagging. Já para exclua tags de bucket, requer-se a permissão oss:DeleteBucketTagging. 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 atualize 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 informações sobre tags de bucket, consulte Gerencie tags de bucket.

Adicionar ou modifique tags de bucket

A marcação de bucket utiliza pares chave-valor como tags para identificar buckets. Somente o proprietário do bucket e usuários com a permissão PutBucketTags podem adicionar ou modifique tags. Se outros usuários tentarem realizar essas ações, o sistema retornará 403 Forbidden com o código de erro AccessDenied.

• Sintaxe do comando

  ossutil bucket-tagging --method put oss://bucketname key#value

  A tabela a seguir descreve os parâmetros anteriores.

  Parâmetro	Descrição
  bucketname	Nome do bucket ao qual você deseja adicionar uma tag ou cuja tag deseja modifique.
  key#value	Par chave-valor da tag. A chave e o valor da tag são separados por um sinal de número (#) e devem estar codificados em UTF-8. A chave pode ter até 64 caracteres e não pode conter o prefixo http://, https:// ou Aliyun. A chave não pode estar vazia. O valor pode ter até 128 caracteres e pode estar vazio.

  Se a tag especificada no comando não existir, ela será adicionada ao bucket. Caso já exista, o sistema substituirá a tag existente.

• Exemplos

  O comando de exemplo a seguir adiciona duas tags a um bucket chamado examplebucket. Uma tag tem a chave tag1 e o valor test1; a outra tem a chave tag2 e o valor test2.

  ossutil bucket-tagging --method put oss://examplebucket  tag1#test1 tag2#test2

  A saída de exemplo abaixo indica que as tags foram adicionadas.

  0.300600(s) elapsed

Consultar tags de bucket

• Sintaxe do comando

  ossutil bucket-tagging --method get oss://bucketname

• Exemplos

  O comando de exemplo a seguir consulta as tags de um bucket chamado examplebucket:

  ossutil bucket-tagging --method get oss://examplebucket

  A saída de exemplo abaixo mostra que o bucket examplebucket possui duas tags. Uma tem a chave tag1 e o valor test1; a outra tem a chave tag2 e o valor test2.

  index     tag key       tag value
  ---------------------------------------------------
  0         "tag1"        "test1"
  1         "tag2"        "test2"
  
  0.283359(s) elapsed

Exclua tags

• Sintaxe do comando

  ossutil bucket-tagging --method delete oss://bucketname 

• Exemplos

  O comando de exemplo a seguir exclua todas as tags de um bucket chamado examplebucket.

  Nota

  O ossutil permite exclua todas as tags de um bucket. Não é possível usar o ossutil para exclua apenas tags específicas. Para exclua tags específicas de um bucket, chame a operação DeleteBucketTags.

  ossutil bucket-tagging --method delete oss://examplebucket

  A saída de exemplo abaixo indica que todas as tags do examplebucket foram excluídas.

  0.530750(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, use -i para o AccessKey ID e -k para o AccessKey secret.

ossutil bucket-tagging--method put oss://examplebucket key#value -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Opções comuns.