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 os recursos mais recentes do Cloud Storage, como a exclusão reversível e as pastas gerenciadas.

  • Os comandos gcloud storage exigem menos otimização manual para atingir as taxas de upload e download mais rápidas.

Como migrar para a gcloud CLI

Se você é um usuário do gsutil que quer migrar para a gcloud CLI, primeiro deve verificar se está usando uma versão independente do gsutil executando o seguinte comando:

gsutil version -l

  • Quando o resultado do comando inclui using cloud sdk: False, isso significa que você está usando uma versão independente do gsutil. Para migrar para a gcloud CLI, acesse Como instalar a gcloud CLI.

  • Quando o resultado do comando inclui using cloud sdk: True, isso significa que você já tem a gcloud CLI instalada.

Depois que a gcloud CLI for instalada, será possível usar comandos gcloud storage da mesma forma que comandos gsutil. Estes recursos podem ajudar você a começar:

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 conferir 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 usando Ctrl-C.

A seguir