Esta página mostra-lhe como listar os contentores do Cloud Storage num projeto, que são ordenados lexicograficamente por nome na lista.
Antes de começar
Para receber as autorizações de que precisa para listar contentores, peça ao seu administrador para lhe conceder a função de administrador de armazenamento (roles/storage.admin
) do IAM ou a função básica de leitor (roles/viewer
) no projeto que contém os contentores que quer listar.
Para mais informações sobre a concessão de funções para projetos, consulte o artigo Gerir o acesso a projetos.
As funções contêm a autorização storage.buckets.list
, que é necessária para listar contentores. Também pode receber esta autorização com funções personalizadas.
Apresenta os contentores num projeto
Consola
- Na Google Cloud consola, aceda à página Recipientes do Cloud Storage.
Os contentores que fazem parte do projeto atualmente selecionado são apresentados na lista.
Opcionalmente, use a filtragem e a ordenação para limitar e organizar os resultados na sua lista.
Linha de comandos
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
No seu ambiente de programação, execute o comando
gcloud storage ls
:gcloud storage ls
A resposta tem o seguinte aspeto:
gs://BUCKET_NAME1/ gs://BUCKET_NAME2/ gs://BUCKET_NAME3/ ...
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com um pedido para listar contentores:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b?project=PROJECT_IDENTIFIER"
Em que
PROJECT_IDENTIFIER
é o ID ou o número do projeto que contém os contentores que quer listar. Por exemplo,my-project
.Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API XML com um pedido deGET
serviço:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.googleapis.com"
Onde
PROJECT_ID
é o ID do projeto que contém os contentores que quer listar. Por exemplo,my-project
.
Bibliotecas cliente
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 as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
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 as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Go
Para mais informações, consulte a documentação de referência da API Go do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
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 as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Node.js
Para mais informações, consulte a documentação de referência da API Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
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 as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Python
Para mais informações, consulte a documentação de referência da API Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Ruby
Para mais informações, consulte a documentação de referência da API Ruby do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
APIs REST
API JSON
API XML
O que se segue?
- Obtenha informações sobre o tamanho de um contentor.
- Liste os objetos num contentor.
- Mova ou mude o nome de um contentor.
- Elimine um contentor.
- Saiba como paginar os resultados.