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).

Para uma lista completa de guias para concluir tarefas com o gsutil, consulte Guias de instruções do Cloud Storage.

Primeiros passos

A melhor maneira de começar a usar a ferramenta gsutil é seguir o Guia de início rápido do gsutil. O guia de início rápido mostra como configurar um projeto do Google Cloud, ativar o faturamento, instalar o gsutil e executar comandos básicos com a ferramenta.

Se outra pessoa já tiver configurado uma conta do Cloud Storage e adicionado você ao projeto como um membro da equipe, ou se você tiver recebido acesso a um objeto ou bucket, poderá conseguir o gsutil como parte do SDK do Cloud para acessar os dados protegidos. Você não precisa ativar o Cloud Storage nem configurar o faturamento.

Como acessar dados públicos

Se você quiser acessar apenas dados públicos, siga as instruções em Como acessar dados públicos. Ao seguir as etapas encontradas na guia gsutil, é possível acessar imediatamente dados disponíveis gratuitamente e acessíveis ao público. Não é necessário se inscrever em uma Conta do Google ou se autenticar no Cloud Storage para usar o gsutil com essa finalidade.

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.

Por padrão, o gsutil acessa o Cloud Storage por meio de pontos de extremidade de solicitação da API JSON. É possível alterar esse padrão para a API XML.

Ajuda integrada

O gsutil contém ajuda integrada completa sobre todos os comandos, além de diversos tópicos que você pode conseguir executando:

gsutil help

Esse comando gera uma lista de todos os comandos e tópicos de ajuda disponíveis, possibilitando que você receba ajuda detalhada para cada comando ou tópico. Por exemplo, é possível obter ajuda sobre o comando gsutil cp executando:

gsutil help cp

Para informações sobre as opções de linha de comando de nível superior do gsutil, use:

gsutil help options

Para informações sobre a instalação do gsutil, use:

gsutil version -l

As páginas de ajuda do gsutil também estão disponíveis on-line. Por exemplo, as páginas on-line dos comandos mostrados acima são ajuda do gsutil, gsutil cp, opções do gsutil e versão do gsutil.

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 desativar essas estatísticas de uso, siga as instruções relevantes:

  • Se você instalou o gsutil como parte do SDK do Cloud, consulte Estatísticas de uso.
  • Se você instalou o gsutil como uma versão autônoma, exclua o arquivo /.gsutil/analytics-uuid.

Sobre o gsutil

O gsutil é um projeto de código aberto. Para fazer o download da versão de desenvolvedor do gsutil ou se voluntariar para ajudar a desenvolvê-lo, visite o projeto do gsutil (em inglês) no GitHub.

A seguir