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 intervalo e de objeto, incluindo:

  • criar e excluir intervalos;
  • fazer upload, download e exclusão de objetos;
  • listar intervalos e objetos;
  • mover, copiar e renomear objetos;
  • editar ACLs de objetos e intervalos.

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

Para ajuda da comunidade, consulte as perguntas sobre o gsutil no Stack Overflow (em inglês).

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 Platform, 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 a um intervalo, poderá conseguir o gsutil como parte do SDK do Google Cloud para acessar o 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, você pode 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

O 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. Você pode 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, e você pode receber ajuda detalhada para cada comando ou tópico. Por exemplo, você pode receber 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.

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.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.