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
- Instalar o gsutil.
- Leia os guias para concluir tarefas usando a gsutil.
- Veja a discussão da comunidade nas perguntas do Stack Overflow do gsutil.