Todos os produtos
Search
Central de documentação

Object Storage Service:stat (Visualize bucket and object information)

Última atualização: Jul 03, 2026

Use o comando stat para visualizar informações sobre um bucket ou objeto específico. Por exemplo, consulte a classe de armazenamento de um bucket e os metadados de um objeto.

Importante
  • A partir da versão 1.6.16 do ossutil, use ossutil como nome do binário na linha de comando. Não é necessário alterar o nome do binário para diferentes sistemas operacionais. Se você usar uma versão anterior à 1.6.16, use o nome do binário específico para o seu sistema operacional. Para mais informações, consulte Referência de comandos do ossutil.

  • Somente o proprietário do bucket e usuários do Resource Access Management (RAM) com as permissões oss:GetObject, oss:GetObjectAcl e oss:GetBucketInfo podem usar este comando para visualizar metadados de objetos.

Sintaxe do comando

ossutil stat oss://bucketname[/objectname]
[--encoding-type <value>]
[--payer <value>]
[--version-id <value>]

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

Parâmetro

Descrição

bucketname

Nome do bucket de destino.

objectname

Nome do objeto de destino.

--encoding-type

Método de codificação do nome do objeto. Defina o valor como url. Se você não especificar esta opção, o nome do objeto não será codificado.

--payer

Método de pagamento da solicitação. Para que o solicitante pague as taxas geradas pelo acesso aos recursos no caminho especificado, como tráfego e solicitações, defina esta opção como requester.

--version-id

Versão do objeto. Esta opção aplica-se apenas a objetos em buckets com versionamento ativado ou suspenso.

Exemplos

  • Visualize informações sobre o bucket examplebucket.

     ossutil stat oss://examplebucket

    A saída abaixo mostra as informações retornadas para examplebucket, incluindo nome do bucket, região, data de criação e lista de controle de acesso (ACL).

    Name              : examplebucket
    Location          : oss-cn-hangzhou
    CreationDate      : 2021-06-30 16:04:41 +0800 CST
    ExtranetEndpoint  : oss-cn-hangzhou.aliyuncs.com
    IntranetEndpoint  : oss-cn-hangzhou-internal.aliyuncs.com
    ACL               : private
    Owner             : 148562088256****
    StorageClass      : Standard
    RedundancyType    : LRS
    AccessMonitor     : Enabled
    
    0.132413(s) elapsed
  • Visualize informações sobre o objeto exampleobject.jpg no bucket examplebucket.

    ossutil stat oss://examplebucket/exampleobject.jpg

    A saída a seguir exibe os dados retornados para exampleobject.jpg. As informações incluem ACL e metadados do arquivo, como Content-Type, valor ETag e hora da última modificação.

    ACL                   : default
    Accept-Ranges         : bytes
    Content-Length        : 8746
    Content-Md5           : cvc5wcklut76CVoEi2UW****
    Content-Type          : image/jpeg
    Etag                  : 72F739C1C925BADEFA095A048B65****
    Last-Modified         : 2021-07-27 09:53:03 +0800 CST
    Owner                 : 148562088256****
    X-Oss-Hash-Crc64ecma  : 56037670485008****
    X-Oss-Object-Type     : Normal
    X-Oss-Storage-Class   : Standard
    
    0.194739(s) elapsed
  • Visualize informações sobre um objeto cujo nome contenha caracteres especiais no bucket examplebucket.

    Por exemplo, para visualizar informações sobre o objeto example.txt no bucket examplebucket. Se o nome do objeto tiver caracteres especiais que não possam ser digitados ou reconhecidos, aplique a codificação URL ao nome, pois o ossutil oferece suporte apenas à codificação URL para nomes de objetos.

    ossutil stat oss://examplebucket/%E7%A4%BA%E4%BE%8B.txt --encoding-type url

    A resposta abaixo fornece detalhes sobre Example.txt, incluindo sua lista de controle de acesso (ACL), Content-Type, valor ETag e hora da última modificação.

    ACL                   : default
    Accept-Ranges         : bytes
    Content-Length        : 113089
    Content-Md5           : mAYgHM5cSkZNBxKDDqqW****
    Content-Type          : image/jpeg
    Etag                  : 9806201CCE5C4A464D0712830EAA****
    Last-Modified         : 2021-07-27 10:08:57 +0800 CST
    Owner                 : 148562088256****
    X-Oss-Hash-Crc64ecma  : 1106061527435521****
    X-Oss-Object-Type     : Normal
    X-Oss-Storage-Class   : Standard
    
    0.168335(s) elapsed
  • Visualize informações sobre uma versão específica de um objeto no bucket examplebucket.

    ossutil stat oss://examplebucket/test.jpg --version-id  CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz****

    Para mais informações sobre como obter versões de objetos, consulte ls.

    A saída a seguir apresenta os dados retornados para a versão especificada do objeto, incluindo ACL, metadados do arquivo (como Content-Type, valor ETag e hora da última modificação) e ID da versão.

    ACL                   : default
    Accept-Ranges         : bytes
    Content-Length        : 190540
    Content-Md5           : aJQnxHQ2b+zW6hh0c+2y****
    Content-Type          : image/jpeg
    Etag                  : 689427C474366FECD6EA187473ED****
    Last-Modified         : 2021-07-27 10:19:25 +0800 CST
    Owner                 : 148562088256****
    X-Oss-Hash-Crc64ecma  : 1666171672179499****
    X-Oss-Object-Type     : Normal
    X-Oss-Storage-Class   : Standard
    X-Oss-Version-Id      : CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz****
    
    0.213528(s) elapsed

Opções comuns

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

Por exemplo, para obter informações sobre o bucket testbucket, localizado na região China (Shanghai) e pertencente a outra conta Alibaba Cloud, execute o seguinte comando:

ossutil stat oss://testbucket  -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Opções comuns.