Todos os produtos
Search
Central de documentação

Object Storage Service:cat

Última atualização: Sep 22, 2026

Este tópico descreve como executar o comando cat para visualizar o conteúdo de um objeto específico em um bucket.

Observações de uso

  • Para visualizar o conteúdo de um objeto, você precisa ter a permissão oss:GetObject. Para mais informações, consulte Grant a custom policy.

  • A partir do ossutil 1.6.16, você pode usar diretamente ossutil como nome do binário na linha de comando, sem necessidade de atualize o nome do binário conforme o sistema operacional. Para versões anteriores ao ossutil 1.6.16, atualize o nome do binário de acordo com o sistema operacional. Para mais informações, consulte ossutil command reference.

Sintaxe do comando

ossutil cat oss://bucketname/objectname [--payer <value>] [--version-id <value>]
Importante

Recomendamos utilizar este comando para visualizar conteúdo em formato TXT.

A tabela a seguir descreve os parâmetros mencionados acima.

Parâmetro

Descrição

bucketname

Nome do bucket.

objectname

Nome do objeto.

--payer

Responsável pelo pagamento da solicitação. Para que o solicitante que acessa os recursos no caminho especificado arque com os custos gerados pela operação, como taxas de tráfego e de requisição, defina este parâmetro como requester.

--version-id

ID de versão do objeto. Este parâmetro se aplica apenas a buckets com versionamento ativado ou suspenso.

Exemplos

  • Visualize o conteúdo do objeto test.txt no bucket examplebucket sem versionamento ativado.

    ossutil cat oss://examplebucket/test.txt

    A saída a seguir exibe o conteúdo do objeto test.txt e o tempo necessário para retornar o resultado:

    My Website Home Page.
    
    0.088092(s) elapsed
  • Visualize o conteúdo do objeto exampleobject.txt no bucket examplebucket com versionamento ativado.

    ossutil cat oss://examplebucket/exampleobject.txt --version-id  CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3****

    Para mais informações sobre como consultar todas as versões de um objeto, consulte ls (List buckets, objects, or parts).

    A saída a seguir exibe o conteúdo da versão especificada do objeto test.txt e o tempo necessário para retornar o resultado:

    Hello World.
    
    0.044820(s) elapsed

Opções comuns

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

Por exemplo, para visualizar o conteúdo do objeto exampleobject1.txt no bucket examplebucket1 pertencente a outra conta Alibaba Cloud na região China (Shanghai), execute o seguinte comando:

ossutil cat oss://examplebucket1/exampleobject1.txt -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Common options.