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 inferior do console do 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 de desenvolvimento, 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.
O exemplo 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#
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.
O exemplo 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
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
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.
O exemplo a seguir lista todos os buckets disponíveis. Se um local estiver temporariamente indisponível, a resposta também incluirá os nomes de todos os 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
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
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.
O exemplo a seguir lista todos os buckets disponíveis. Se um local estiver temporariamente indisponível, a resposta também incluirá os nomes de todos os 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
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
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.
O exemplo 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
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
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.
O exemplo a seguir lista todos os buckets disponíveis. Se um local estiver temporariamente indisponível, a resposta também incluirá os nomes de todos os 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
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
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.
O exemplo 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
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
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.
O exemplo 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 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 buckets não puderem ser acessados porque um local está temporariamente indisponível. Se definido comofalse, a solicitação retornará uma lista de buckets somente se todos os locais puderem ser acessados. Caso contrário, ela 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
cURL(em inglês) para 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.