Todos os produtos
Search
Central de documentação

Object Storage Service:get-object-meta

Última atualização: Sep 22, 2026

O comando get-object-meta consulta os metadados de um objeto, incluindo ETag, Size e LastModified, sem retornar o conteúdo do objeto.

Observações de uso

  • Por padrão, uma conta Alibaba Cloud tem permissão para consultar os metadados de um objeto. Consultar como usuário RAM ou usando o Security Token Service (STS) requer a permissão oss:GetObject. Para mais detalhes, consulte Grant a custom policy.

  • Os metadados de um objeto incluem ETag, Size e LastModified, sem retornar o conteúdo do objeto. Se o objeto for um link simbólico, a resposta traz as informações sobre esse link.

Sintaxe do comando

ossutil api get-object-meta --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 da versão dos metadados do objeto.

Nota
  • O comando get-object-meta corresponde à operação GetObjectMeta. Para saber mais sobre os parâmetros da operação GetObjectMeta, consulte GetObjectMeta.

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

Exemplos

  • Consulte parte dos metadados de exampleobject.

    ossutil api get-object-meta --bucket examplebucket --key exampleobject
  • Obtenha parte dos metadados de exampleobject e exiba a saída no formato JSON.

    ossutil api get-object-meta --bucket examplebucket --key exampleobject --output-format json
  • Recupere parte dos metadados de exampleobject cujo ID de versão é 123.

    ossutil api get-object-meta --bucket examplebucket --key exampleobject --version-id 123