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.
A partir da versão 1.6.16 do ossutil, use
ossutilcomo 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:GetObjectAcleoss:GetBucketInfopodem 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://examplebucketA 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.jpgno bucketexamplebucket.ossutil stat oss://examplebucket/exampleobject.jpgA 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 urlA 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