Guia de início rápido: como usar a ferramenta gsutil

Nesta página, mostraremos como executar tarefas básicas no Cloud Storage usando a ferramenta de linha de comando gsutil.

Os custos gerados no Cloud Storage são baseados nos recursos que você usa. Este guia de início rápido geralmente usa menos de US$ 0,01 em recursos do Cloud Storage.

Antes de começar

1. Faça login na sua Conta do Google.

   Se você ainda não tiver uma, inscreva-se.

2. No Console do GCP, acesse a página Gerenciar recursos e crie um projeto.

   Acessar a página Gerenciar recursos

3. Verifique se o faturamento foi ativado no projeto do Google Cloud Platform.

   Saiba como ativar o faturamento

4. Instale o SDK do Cloud.

   Quando solicitado, escolha o projeto que você criou acima.

5. Instale o Python 2.7.

   Se você estiver usando o Windows e tiver deixado a caixa de seleção relevante selecionada quando instalou o SDK do Cloud, isso foi feito automaticamente.

Observação: ao usar o Google Cloud Shell ou uma instância do Google Compute Engine, o Python e o gsutil serão pré-instalados e autenticados. Se a instância do Google Compute Engine estiver configurada sem o escopo de conta de serviço no Cloud Storage, execute gsutil config e siga as instruções.

Observação: se você usa o Windows e não instalou o gsutil como parte do SDK do Cloud, será necessário preceder cada comando gsutil com python. Por exemplo, python gsutil mb gs://my-awesome-bucket. Para mais informações, consulte as Perguntas frequentes sobre o Python no Windows.

Criar um intervalo

Intervalos são os contêineres básicos que armazenam seus dados no Cloud Storage.

Para criar um intervalo:

1. Abra uma janela de terminal.
2. Use o comando gsutil mb e um nome exclusivo para criar um intervalo:

   gsutil mb -l us-east1 gs://my-awesome-bucket/
   

   Isso usa um intervalo chamado "my-awesome-bucket". É necessário escolher seu próprio nome de intervalo globalmente exclusivo.

   Consulte os requisitos de nomenclatura de intervalo.

   • Nomes de intervalo precisam conter apenas letras minúsculas, números, traços (-), sublinhados (_) e pontos (.). Os nomes com pontos precisam de verificação.
   • Nomes de intervalo precisam começar e terminar com uma letra ou um número.
   • Nomes de intervalo precisam conter de 3 a 63 caracteres. Os nomes com pontos podem ter até 222 caracteres, mas cada componente separado por ponto não pode ter mais do que 63 caracteres.
   • Nomes de intervalo não podem ser representados como um endereço IP na notação decimal com pontos (por exemplo, 192.168.5.4).
   • Nomes de intervalo não podem começar com o prefixo "goog".
   • Nomes de intervalo não podem conter ou se assemelhar a "google", como em "g00gle".

   Além disso, para fins de conformidade e compatibilidade futura de DNS, você não deve usar sublinhados (_) ou ter um ponto adjacente a outro ponto ou traço. Por exemplo, "..", "-." ou ".-" não são nomes DNS válidos.

   Cuidado: não inclua informações confidenciais no nome do intervalo, uma vez que o namespace dele é global e visível para o público.

   Se for bem-sucedido, o comando retornará:

   Creating gs://my-awesome-bucket/...
   

Você acabou de criar um intervalo para armazenar seus dados!

Observação: se o nome do intervalo já está sendo usado por você ou por outra pessoa, o comando retorna:
    Creating gs://my-awesome-bucket/...
    ServiceException: 409 Bucket my-awesome-bucket already exists.
Tente novamente com um nome de intervalo diferente.

Fazer upload de um objeto no seu intervalo

1. Clique com o botão direito na imagem acima e salve-a em algum lugar no seu computador, como na área de trabalho.

   Observação: se você estiver usando o Cloud Shell ou uma instância do Compute Engine, faça o download da imagem por meio de wget https://cloud.google.com/storage/images/kitten.png.

2. Use o comando gsutil cp para copiar a imagem no local em que você a salvou e enviá-la para o intervalo criado.

   gsutil cp Desktop/kitten.png gs://my-awesome-bucket

   Se for bem-sucedido, o comando retornará:

   Copying file://Desktop/kitten.png [Content-Type=image/png]...
   Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
   Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

   Você acabou de armazenar um objeto no seu intervalo.

Observação: use a tecla Tab para preencher automaticamente o nome do intervalo.

Fazer o download de um objeto do seu intervalo

1. Use o gsutil cp para fazer o download da imagem que você armazenou no seu intervalo para algum lugar no seu computador, como na área de trabalho:

   gsutil cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

   Se for bem-sucedido, o comando retornará:

   Copying gs://my-awesome-bucket/kitten.png...
   Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
   Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

   Você acabou de transferir algo do seu intervalo.

Copiar um objeto para uma pasta no intervalo

1. Use o comando gsutil cp para criar uma pasta e copie a imagem para ela:

   gsutil cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png

   Observação: as pastas no Cloud Storage têm limitações em comparação com os sistemas de arquivos locais, mas muitas das mesmas operações são compatíveis.

   Se for bem-sucedido, o comando retornará:

   Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
   Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB

   Você acabou de copiar seu objeto para uma nova pasta no seu intervalo.

Listar conteúdos de um intervalo ou pasta

1. Use o comando gsutil ls para listar o conteúdo no nível superior do seu intervalo:

   gsutil ls gs://my-awesome-bucket

   Se for bem-sucedido, o comando retornará uma mensagem semelhante a:

   gs://my-awesome-bucket/kitten.png
   gs://my-awesome-bucket/just-a-folder/

   Você acabou de ver o conteúdo no nível superior do seu intervalo.

Listar detalhes para um objeto

1. Use o comando gsutil ls, com a sinalização -l para conseguir alguns detalhes sobre um objeto:

   gsutil ls -l gs://my-awesome-bucket/kitten.png

   Se for bem-sucedido, o comando retornará uma mensagem semelhante a:

   2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
   TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)

   Você acabou de conseguir informações sobre o tamanho e a data de criação do objeto.

Tornar seu objeto acessível publicamente

1. Use o comando gsutil acl ch para conceder permissão de leitura a todos os usuários para o objeto armazenado no seu intervalo:

   gsutil acl ch -u AllUsers:R gs://my-awesome-bucket/kitten.png

   Se for bem-sucedido, o comando retornará:

   Updated ACL on gs://my-awesome-bucket/kitten.png

   Agora qualquer um pode acessar seu objeto.

2. Para remover essa permissão, use o comando:

   gsutil acl ch -d AllUsers gs://my-awesome-bucket/kitten.png

   Se for bem-sucedido, o comando retornará:

   Updated ACL on gs://my-awesome-bucket/kitten.png

   Você removeu o acesso público a este objeto.

Observação: depois de remover o acesso público, ainda será possível acessar uma versão em cache do objeto por um determinado período.

Conceder acesso ao seu intervalo

1. Use o comando gsutil iam ch para conceder permissão específica a um endereço de e-mail para ler e gravar objetos no seu intervalo:

   gsutil iam ch user:[e-mail]:objectCreator,objectViewer gs://my-awesome-bucket

   O comando será bem-sucedido se nenhum erro for retornado.

   Agora, outra pessoa pode inserir dados e ver seu intervalo.

2. Para remover essa permissão, use o comando:

   gsutil iam ch -d user:[e-mail]:objectCreator,objectViewer gs://my-awesome-bucket

   O comando será bem-sucedido se nenhum erro for retornado.

   Você removeu o acesso do usuário a esse intervalo.

Excluir objetos

1. Use o comando gsutil rm para excluir um objeto:

   gsutil rm gs://my-awesome-bucket/kitten.png

   Se for bem-sucedido, o comando retornará:

   Removing gs://my-awesome-bucket/kitten.png...

   Esta cópia do objeto não está mais armazenada no Cloud Storage (mesmo que a cópia feita na pasta just-a-folder/ ainda exista).

Limpar

Para evitar cobranças na sua conta do GCP pelos recursos usados neste guia de início rápido:

1. Abra uma janela do terminal, se já não estiver aberta.

2. Use o comando rm command com a sinalização -r para excluir o intervalo e tudo que houver dentro dele:

   gsutil rm -r gs://my-awesome-bucket

   Se for bem-sucedido, o comando retornará uma mensagem semelhante a:

   Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
   Removing gs://my-awesome-bucket/...

   Seu intervalo e o conteúdo dele foram excluídos.

Próximas etapas

• Trabalhe com o guia de início rápido do Cloud Storage usando o console do Google Cloud Platform.
• Consulte os guias disponíveis para concluir tarefas no Cloud Storage.
• Conheça os principais termos usados no Cloud Storage.
• Saiba mais sobre a estrutura de preços do Cloud Storage.
• Consulte as páginas de referência dos comandos do gsutil, como criar intervalo (mb), copiar (cp), listar (ls), lista de controle de acesso (acl), gerenciamento de identidade e acesso (iam) e remover (rm).