O gsutil é um aplicativo em Python que permite acessar o Cloud Storage da linha de comando. É possível usar o gsutil para executar uma ampla gama de tarefas de gerenciamento de bucket e de objeto, incluindo:
- criar e excluir buckets;
- fazer upload, download e exclusão de objetos;
- listar buckets e objetos;
- mover, copiar e renomear objetos;
- editar ACLs de objetos e buckets.
A gsutil executa todas as operações, incluindo uploads e downloads, usando HTTPS e TLS (Transport Layer Security).
Você precisa usar a gsutil?
Geralmente, é preciso usar comandos gcloud storage
em vez de gsutil
:
A ferramenta gsutil é uma CLI legada do Cloud Storage com manutenção mínima.
A ferramenta gsutil não é compatível com o trabalho com recursos mais recentes do Cloud Storage.
Os comandos
gcloud storage
exigem menos otimização manual para atingir as taxas de upload e download mais rápidas.
Sintaxe para acessar recursos
gsutil usa o prefixo gs://
para indicar um recurso no Cloud Storage.
gs://BUCKET_NAME/OBJECT_NAME
Além de especificar recursos exatos, o gsutil é compatível com o uso de curingas nos seus comandos.
Ajuda integrada
O gsutil contém ajuda integrada completa sobre todos os comandos, além de diversos tópicos que você pode listar e ler com o comando gsutil help
.
Para informações sobre um comando ou tópico específico, use gsutil help
seguido pelo nome do tópico ou comando pretendido. Por exemplo, gsutil help cp
e gsutil help options
são páginas de ajuda de comando e de tópico, respectivamente.
Para informações sobre a instalação do gsutil, use o comando gsutil version:
gsutil version -l
Estatísticas de uso
Durante o processo de instalação, é possível ativar o rastreamento das estatísticas de uso, o que ajuda a melhorar a ferramenta gsutil. Se você decidir desativá-las, consulte Estatísticas de uso.
Sobre o gsutil
O gsutil é um projeto de código aberto. Para fazer o download da versão do desenvolvedor do gsutil ou se voluntariar para ajudar a desenvolvê-lo, acesse o projeto do gsutil (em inglês) no GitHub.
Limitações
- Ao usar a gsutil com o Windows, os comandos que usam a flag global
-m
não podem ser cancelados usandoCtrl-C
.
A seguir
- Instalar o gsutil.
- Veja a discussão da comunidade nas perguntas do Stack Overflow do gsutil.