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 do Google 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 do Google Cloud para realizar as tarefas nesta página.
storage.objects.get
storage.objects.list
- Essa permissão é necessária apenas para usar o console do 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 Usar o IAM com 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 do 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 autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage C#.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
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
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
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
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
APIs REST
API JSON
Ter a gcloud CLI instalada e inicializadapara gerar um token de acesso para o cabeçalho
Authorization
.Como alternativa, é possível criar um token de acesso usando o OAuth 2.0 Playground e incluí-lo no cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com uma solicitação deGET
Objeto:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Em que:
SAVE_TO_LOCATION
é o caminho para o local onde você quer salvar o objeto. Por exemplo,Desktop/dog.png
.BUCKET_NAME
é o nome do bucket que contém o objeto que você está baixando. Por exemplo,my-bucket
.OBJECT_NAME
é o nome codificado por URL do objeto que você está fazendo o download. Por exemplo,pets/dog.png
, codificado por URL comopets%2Fdog.png
.
API XML
Ter a gcloud CLI instalada e inicializadapara gerar um token de acesso para o cabeçalho
Authorization
.Como alternativa, é possível criar um token de acesso usando o OAuth 2.0 Playground e incluí-lo no cabeçalho
Authorization
.Use
cURL
(em inglês) para chamar a API XML com uma solicitação de objetoGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Em que:
SAVE_TO_LOCATION
é o caminho para o local onde você quer salvar o objeto. Por exemplo,Desktop/dog.png
.BUCKET_NAME
é o nome do bucket que contém o objeto que você está baixando. Por exemplo,my-bucket
.OBJECT_NAME
é o nome codificado por URL do objeto que você está fazendo o download. Por exemplo,pets/dog.png
, codificado por URL comopets%2Fdog.png
.
Para fazer o download de todos os objetos em um bucket ou subdiretório com mais eficiência, use o
comando gcloud storage cp
ou uma biblioteca de cliente.
Fazer o download de uma parte de um objeto
Se o download for interrompido, será possível retomar de onde você parou solicitando apenas a parte do objeto restante. Conclua as instruções a seguir para fazer o download de uma parte de um objeto.
Console
O console do Google Cloud não é compatível com o download de partes de um objeto. Em vez disso, use a CLI gcloud.
Linha de comando
A CLI do Google Cloud tenta retomar automaticamente os downloads interrompidos,
exceto ao realizar downloads de streaming. Se o download for
interrompido, um arquivo temporário com download parcial ficará visível na
hierarquia de destino. Execute o mesmo comando cp
para retomar o
download de onde parou.
Quando o download estiver concluído, o arquivo temporário será excluído e substituído pelo conteúdo do download. Os arquivos temporários são armazenados em um local configurável, que, por padrão, fica no diretório inicial do usuário em .config/gcloud/surface_data/storage/tracker_files
. Para alterar ou ver o local em que os arquivos temporários são armazenados, execute gcloud config get storage/tracker_files_directory
.
Bibliotecas de cliente
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage C#.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage Go.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage Java.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage Node.js.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage PHP.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage Python.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage Ruby.
Para autenticar no Cloud Storage, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
APIs REST
API JSON
Use o cabeçalho Range
na solicitação para fazer o download de uma parte de
um objeto.
Ter a gcloud CLI instalada e inicializadapara gerar um token de acesso para o cabeçalho
Authorization
.Como alternativa, é possível criar um token de acesso usando o OAuth 2.0 Playground e incluí-lo no cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com uma solicitação deGET
Objeto:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Range: bytes=FIRST_BYTE-LAST_BYTE" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Em que:
FIRST_BYTE
é o primeiro byte no intervalo de bytes que você quer fazer o download. Por exemplo,1000
.LAST_BYTE
é o último byte no intervalo de bytes que você quer fazer o download. Por exemplo,1999
.SAVE_TO_LOCATION
é o caminho para o local onde você quer salvar o objeto. Por exemplo,Desktop/dog.png
.BUCKET_NAME
é o nome do bucket que contém o objeto que você está baixando. Por exemplo,my-bucket
.OBJECT_NAME
é o nome codificado por URL do objeto que você está fazendo o download. Por exemplo,pets/dog.png
, codificado por URL comopets%2Fdog.png
.
API XML
Use o cabeçalho Range
na solicitação para fazer o download de uma parte de
um objeto.
Ter a gcloud CLI instalada e inicializadapara gerar um token de acesso para o cabeçalho
Authorization
.Como alternativa, é possível criar um token de acesso usando o OAuth 2.0 Playground e incluí-lo no cabeçalho
Authorization
.Use
cURL
(em inglês) para chamar a API XML com uma solicitação de objetoGET
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Range: bytes=FIRST_BYTE-LAST_BYTE" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Em que:
FIRST_BYTE
é o primeiro byte no intervalo de bytes que você quer fazer o download. Por exemplo,1000
.LAST_BYTE
é o último byte no intervalo de bytes que você quer fazer o download. Por exemplo,1999
.SAVE_TO_LOCATION
é o caminho para o local onde você quer salvar o objeto. Por exemplo,$HOME/Desktop/dog.png
.BUCKET_NAME
é o nome do bucket que contém o objeto que você está baixando. Por exemplo,my-bucket
.OBJECT_NAME
é o nome codificado por URL do objeto que você está fazendo o download. Por exemplo,pets/dog.png
, codificado por URL comopets%2Fdog.png
.
A seguir
- Consulte a visão geral conceitual dos uploads e downloads, incluindo estratégias avançadas de download.
- Transfira dados de provedores da nuvem ou de outras origens on-line, como listas de URLs.
- Transfira objetos para sua instância do Compute Engine.
- Saiba como faturar as cobranças de acesso ao Cloud Storage para os solicitantes.
- Saiba como o Cloud Storage exibe arquivos GZIP em um estado descompactado.
Faça um teste
Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho do Cloud Storage em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
Faça uma avaliação gratuita do Cloud Storage