Nesta página, você aprenderá a listar os buckets do Cloud Storage em um projeto, ordenados de maneira lexicográfica por nome.
Antes de começar
Para ter as permissões necessárias para listar buckets, peça ao administrador para conceder a você o papel do IAM de Administrador do Storage (roles/storage.admin) ou o papel básico de Leitor (roles/viewer) no projeto que contém os buckets que você quer listar.
Para mais informações sobre como conceder papéis em projetos, consulte Gerenciar acesso a projetos.
Os papéis contêm a permissão storage.buckets.list, que é necessária para listar buckets. Também é possível ter essa permissão com papéis personalizados.
Listar os buckets em um projeto
Console
- No console do Cloud de Confiance , acesse a página Buckets do Cloud Storage.
Os buckets que fazem parte do projeto selecionado aparecem na lista.
Você também pode usar a filtragem e a classificação para limitar e organizar os resultados na sua lista.
Linha de comando
-
No console do Cloud de Confiance , ative o Cloud Shell.
Na parte de baixo do console Cloud de Confiance , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
No ambiente para desenvolvedores, execute o comando
gcloud storage ls:gcloud storage ls
A resposta terá esta aparência:
gs://BUCKET_NAME1/ gs://BUCKET_NAME2/ gs://BUCKET_NAME3/ ...
Bibliotecas de cliente
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar os exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
A amostra a seguir lista todos os buckets disponíveis. Se um local estiver temporariamente indisponível, a resposta também vai incluir os nomes dos buckets que não podem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço vai retornar um erro.
C#
Saiba mais na documentação de referência C# da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar os exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
A amostra a seguir lista todos os buckets disponíveis. Se um local estiver temporariamente indisponível, a resposta também vai incluir os nomes dos buckets que não podem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço vai retornar um erro.
Go
Saiba mais na documentação de referência Go da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar os exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
A amostra a seguir lista todos os buckets disponíveis. Se um local estiver temporariamente indisponível, a resposta também vai incluir os nomes dos buckets que não podem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço vai retornar um erro.
Java
Saiba mais na documentação de referência Java da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar os exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
A amostra a seguir lista todos os buckets disponíveis. Se um local estiver temporariamente indisponível, a resposta também vai incluir os nomes dos buckets que não podem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço vai retornar um erro.
Node.js
Saiba mais na documentação de referência Node.js da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar os exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
A amostra a seguir lista todos os buckets disponíveis. Se um local estiver temporariamente indisponível, a resposta também vai incluir os nomes dos buckets que não podem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço vai retornar um erro.
PHP
Saiba mais na documentação de referência PHP da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar os exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
A amostra a seguir lista todos os buckets disponíveis. Se um local estiver temporariamente indisponível, a resposta também vai incluir os nomes dos buckets que não podem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço vai retornar um erro.
Python
Saiba mais na documentação de referência Python da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar os exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
A amostra a seguir lista todos os buckets disponíveis. Se um local estiver temporariamente indisponível, a resposta também vai incluir os nomes dos buckets que não podem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço vai retornar um erro.
Ruby
Saiba mais na documentação de referência Ruby da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar os exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como s3nsapis.fr.
A amostra a seguir lista todos os buckets disponíveis. Se um local estiver temporariamente indisponível, a resposta também vai incluir os nomes dos buckets que não podem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço vai retornar um erro.
Rust
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço vai retornar um erro.
APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization.Use
cURLpara chamar a API JSON com uma solicitação para listar buckets:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b?project=PROJECT_IDENTIFIER&returnPartialSuccess=RETURN_PARTIAL_SUCCESS_BOOLEAN"
Substitua:
PROJECT_IDENTIFIER: o ID ou o número do projeto que contém os buckets que você quer listar. Por exemplo,my-project.RETURN_PARTIAL_SUCCESS_BOOLEAN: defina esse valor comotruese quiser retornar uma lista de buckets mesmo quando alguns deles não puderem ser acessados porque um local está temporariamente indisponível. Se definido comofalse, a solicitação vai retornar uma lista de intervalos somente se todos os locais puderem ser acessados. Caso contrário, ela vai retornar um erro. O padrão éfalse.
API XML
Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho
Authorization.Use
cURLpara chamar a API XML com uma solicitação de serviçoGET:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.s3nsapis.fr"
Substitua
PROJECT_IDpelo ID do projeto que contém os buckets que você quer listar. Por exemplo,my-project.