Ferramenta gsutil

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.

As páginas de ajuda do gsutil também estão disponíveis on-line. Por exemplo, gsutil cp e gsutil 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 usando Ctrl-C.

A seguir