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.

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.

    Se for bem-sucedido, o comando retornará:

    Creating gs://my-awesome-bucket/...
    
  3. Você acabou de criar um intervalo para armazenar seus dados!

Fazer upload de um objeto no seu intervalo

Imagem de um gatinho.

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

  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.

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

    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.

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:jane@gmail.com: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:jane@gmail.com: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

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

Enviar comentários sobre…

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