Nesta página, mostramos como fazer o download de objetos de buckets no Cloud Storage para armazenamento permanente. Também é possível fazer o download de objetos na memória.
Funções exigidas
Para receber as permissões necessárias para fazer o download de objetos, peça ao administrador para conceder a você o papel de Leitor de objetos do Storage (roles/storage.objectViewer) no bucket. Se você planeja usar o
console doGoogle Cloud , peça ao administrador para conceder a você o papel de Administrador do Storage
(roles/storage.admin) no bucket.
Esses papéis contêm as permissões necessárias para fazer o download de objetos. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
storage.buckets.list- Essa permissão é necessária apenas para usar o console Google Cloud para realizar as tarefas nesta página.
storage.objects.getstorage.objects.list- Essa permissão é necessária apenas para usar o console Google Cloud para realizar as tarefas nesta página.
Também é possível conseguir essas permissões com outros papéis predefinidos ou personalizados.
Para instruções sobre como conceder papéis nos buckets, consulte Definir e gerenciar políticas do IAM em buckets.
fazer o download de um objeto de um bucket;
Conclua as instruções a seguir para fazer o download de um objeto a partir de um bucket:
Console
- No console do Google Cloud , acesse a página Buckets do Cloud Storage.
Na lista de buckets, clique no nome daquele que contém o objeto que você quer fazer o download.
A página Detalhes do bucket é aberta, com a guia Objetos selecionada.
Navegue até o objeto, que pode estar localizado em uma pasta.
Clique no ícone Download associado ao objeto.
As configurações do navegador controlam o local de download do objeto.
Para saber como acessar informações detalhadas de erro sobre operações do Cloud Storage com falha no console Google Cloud , consulte Solução de problemas.
Linha de comando
Use o comando gcloud storage cp:
gcloud storage cp gs://BUCKET_NAME/OBJECT_NAME SAVE_TO_LOCATION
Em que:
BUCKET_NAMEé o nome do bucket que contém o objeto que você está fazendo o download. Por exemplo,my-bucket.OBJECT_NAMEé o nome do objeto do qual você está fazendo o download. Por exemplo,pets/dog.png.SAVE_TO_LOCATIONé o caminho local onde você está salvando o objeto. Por exemplo,Desktop/Images.
Se funcionar, a resposta será parecida com esta:
Completed files 1/1 | 164.3kiB/164.3kiB
Se o download for interrompido antes da conclusão, execute o mesmo cp
comando para retomar o download de onde parou.
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.
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.
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.
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.
O exemplo a seguir faz o download de um objeto individual:
O exemplo a seguir faz o download de vários objetos usando vários processos:
O exemplo a seguir faz o download de todos os objetos com um prefixo comum usando vários processos:
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.
O exemplo a seguir faz o download de um objeto individual:
O exemplo a seguir faz o download de vários objetos usando vários processos:
O exemplo a seguir faz o download de todos os objetos com um prefixo comum usando vários processos:
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.
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.
O exemplo a seguir faz o download de um objeto individual:
O exemplo a seguir faz o download de vários objetos usando vários processos:
No exemplo a seguir, é possível fazer o download de todos os objetos de um bucket usando vários processos:
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.