Todos os produtos
Search
Central de documentação

Object Storage Service:stat

Última atualização: Jul 03, 2026

Este tópico descreve como executar o comando stat para consultar informações sobre buckets ou objetos. Por exemplo, use este comando para consultar a classe de armazenamento de um bucket e os metadados de um objeto.

Observações de uso

Somente o proprietário do bucket e usuários RAM com as permissões oss:GetObject, oss:GetObjectAcl e oss:GetBucketInfo podem executar o comando stat para consultar metadados de objetos.

Sintaxe do comando

ossutil stat oss://bucket[/object] [flags]

Parâmetro

Tipo

Descrição

--encoding-type

string

Método de codificação do nome do objeto. Valor válido: url.

--human-readable

/

Exibe as informações em formato legível. A unidade do tamanho do objeto pode ser KB, MB, GB, TB ou PB.

--request-payer

string

Pagador da solicitação. Se o recurso pay-by-requester estiver ativado no bucket, defina este parâmetro como requester. Valor válido: requester.

--version-id

string

ID da versão do objeto.

Exemplos

  • Consulte informações sobre o bucket examplebucket

    ossutil stat oss://examplebucket
  • Consulte informações sobre o objeto exampleobject.txt no bucket examplebucket

    ossutil stat oss://examplebucket/exampleobject.txt 
  • Consulte informações sobre uma versão específica do objeto exampleobject.txt no bucket examplebucket com versionamento ativado

    ossutil stat oss://examplebucket/exampleobject.txt --version-id CAEQKxiBgMCplua..xgiIGFiZjE0NTZkNTU4NjQ5NDdiMDMyMzc4YzIxNDVm****