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 Cloud de Confiance console do, 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 Cloud de Confiance console do, ative o Cloud Shell.
Na parte de baixo do Cloud de Confiance console do, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a Google Cloud CLI 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
gcloud storage lscomando: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 incluirá os nomes de todos os buckets que não puderem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço retornará um erro.
C#
Para mais informações, consulte a documentação de referência da API C# do 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.
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 puderem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço 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 puderem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço retornará um erro.
Java
Para mais informações, consulte a documentação de referência da API Java do 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.
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 puderem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço retornará um erro.
Node.js
Para mais informações, consulte a documentação de referência da APINode.js do 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.
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 puderem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço retornará um erro.
PHP
Para mais informações, consulte a documentação de referência da API PHP do 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.
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 puderem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço 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 incluirá os nomes de todos os buckets que não puderem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço retornará um erro.
Ruby
Para mais informações, consulte a documentação de referência da APIRuby do 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.
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 puderem ser acessados.
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço retornará um erro.
Rust
O exemplo a seguir lista todos os buckets. Se um local estiver temporariamente indisponível, o serviço retornará um erro.
APIs REST
API JSON
Tenha 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 deles 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
Tenha 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 umaGETsolicitação de serviço: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.