Nesta página, veja como listar os objetos armazenados nos buckets do Cloud Storage, que são ordenados na lista de maneira lexicográfica pelo nome. Para uma visão geral dos buckets e objetos, leia os Termos-chave.
Para listar os objetos em um bucket:
Console
- Abra o navegador do Cloud Storage no Console do Google Cloud.
Abra o navegador do Cloud Storage Na lista de buckets, clique no nome do bucket cujo conteúdo você quer visualizar.
Como opção, use a filtragem para restringir os resultados da lista.
gsutil
Use o comando gsutil ls
com a sinalização -r
:
gsutil ls -r gs://BUCKET_NAME/**
Em que:
BUCKET_NAME
é o nome do bucket cujos objetos você quer listar. Por exemplo,my-bucket
.
A resposta terá esta aparência:
gs://my-bucket/cats.jpeg gs://my-bucket/dogs.jpeg gs://my-bucket/thesis.txt ...
Amostras de código
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage para C++.
A amostra a seguir lista todos os objetos de um bucket:
A amostra a seguir lista os objetos com um prefixo determinado:
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage para C#.
A amostra a seguir lista todos os objetos de um bucket:
A amostra a seguir lista os objetos com um prefixo determinado:
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage para Go.
A amostra a seguir lista todos os objetos de um bucket:
A amostra a seguir lista os objetos com um prefixo determinado:
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage para Java.
A amostra a seguir lista todos os objetos de um bucket:
A amostra a seguir lista os objetos com um prefixo determinado:
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage para Node.js.
A amostra a seguir lista todos os objetos de um bucket:
A amostra a seguir lista os objetos com um prefixo determinado:
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage para PHP.
A amostra a seguir lista todos os objetos de um bucket:
A amostra a seguir lista os objetos com um prefixo determinado:
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage para Python.
A amostra a seguir lista todos os objetos de um bucket:
A amostra a seguir lista os objetos com um prefixo determinado:
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage para Ruby.
A amostra a seguir lista todos os objetos de um bucket:
A amostra a seguir lista os objetos com um prefixo determinado:
APIs REST
API JSON
- Consiga um token de acesso de autorização do OAuth 2.0 Playground (em inglês). Configure o Playground para usar suas credenciais do OAuth.
Use
cURL
(em inglês) para chamar a API JSON com uma solicitação de bucketGET
:curl -X GET -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o"
Em que:
OAUTH2_TOKEN
é o token de acesso gerado na etapa 1.BUCKET_NAME
é o nome do bucket cujos objetos você quer listar. Por exemplo,my-bucket
.
É possível usar um parâmetro de string de consulta
prefix=PREFIX
para limitar os resultados a objetos que tenham o prefixo especificado.
API XML
- Consiga um token de acesso de autorização do OAuth 2.0 Playground (em inglês). Configure o Playground para usar suas credenciais do OAuth.
Use
cURL
(em inglês) para chamar a API XML com uma solicitação bucketGET
:curl -X GET -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME"
Em que:
OAUTH2_TOKEN
é o token de acesso gerado na etapa 1.BUCKET_NAME
é o nome do bucket cujos objetos você quer listar. Por exemplo,my-bucket
.
É possível usar um parâmetro de string de consulta
prefix=PREFIX
para limitar os resultados a buckets que tenham o prefixo especificado.
A seguir
- Faça o download de um objeto do seu bucket.
- Visualize e edite metadados de objetos.
- Exclua objetos do bucket.