Todos os produtos
Search
Central de documentação

Object Storage Service:get-object-tagging

Última atualização: Sep 24, 2026

O comando get-object-tagging consulta as tags de um objeto.

Notas de uso

  • Por padrão, uma conta Alibaba Cloud tem permissões para consultar as tags de um objeto. Para fazer consultas como usuário RAM ou por meio do Security Token Service (STS), é necessário ter a permissão oss:GetObjectTagging. Para mais informações, consulte Grant a custom policy.

  • Por padrão, o comando get-object-tagging consulta as tags da versão atual de um objeto. Especifique um ID de versão na requisição para consultar as tags de uma versão específica.

Sintaxe do comando

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

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

--key

string

Caminho completo do objeto.

--version-id

string

ID de versão do objeto.

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

  • Para obter detalhes sobre as opções globais de linha de comando compatíveis, consulte Command-line options.

Exemplos

  • Consulte as tags de examplebucket.

    ossutil api get-object-tagging --bucket examplebucket --key exampleobject
  • Consulte as tags de examplebucket e exiba o resultado no formato JSON.

    ossutil api get-object-tagging --bucket examplebucket --key exampleobject --output-format json
  • Consulte as tags de examplebucket e exiba o resultado no formato YAML.

    ossutil api get-object-tagging --bucket examplebucket --key exampleobject --output-format yaml