Primeiros passos: como usar a ferramenta gsutil

Nesta página, você verá 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

Faça login na sua Conta do Google.
Se você ainda não tiver uma, inscreva-se.
No Console do GCP, na página do seletor de projetos, clique em Criar para começar a criar um novo projeto do GCP.

Acesse a página do seletor de projetos
Verifique se o faturamento foi ativado no projeto do Google Cloud Platform. Saiba como confirmar que o faturamento está ativado para seu projeto.
Instale o SDK do Cloud.
Quando for solicitado, escolha o projeto que você criou acima.
Instale o Python 2.7.
Se você está usando o Windows e marcou a caixa de seleção pertinente 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:

Abra uma janela de terminal.
Use o comando gsutil mb e um nome exclusivo para criar um intervalo:
```
gsutil mb -l us-east1 gs://my-awesome-bucket/
```
O exemplo usa um intervalo chamado "my-awesome-bucket". Escolha seu próprio nome de intervalo globalmente exclusivo.
Consulte os requisitos de nomenclatura de intervalo.
- Os nomes de intervalo precisam conter apenas letras minúsculas, números, traços (-), sublinhados (_) e pontos (.). Espaços não são permitidos. Os nomes com pontos precisam de verificação.
- Nomes de intervalo precisam começar e terminar com um número ou letra.
- Os 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 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 a palavra "google" ou variações dela, como "g00gle".
Além disso, para fins de conformidade de DNS e compatibilidade futura, você não deve usar sublinhados (_) ou um ponto ao lado de 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, já que o namespace dele é global e visível para o público.
Se funcionar, 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á estiver sendo usado por você ou por outra pessoa, o comando retornará:

    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 intervalo

Imagem de um gatinho.

Clique com o botão direito na imagem acima e salve-a em algum lugar do computador, por exemplo, 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 usando wget https://cloud.google.com/storage/images/kitten.png.

Use o comando gsutil cp para copiar a imagem do local em que você a salvou para o intervalo criado:

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

Se funcionar, 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 intervalo.

Fazer o download de um objeto do intervalo

Use o comando gsutil cp para fazer o download da imagem armazenada no seu intervalo para algum lugar no computador, como a área de trabalho:

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

Se funcionar, 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

Use o comando gsutil cp para criar uma pasta e copiar a imagem nela:
```
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 funcionar, 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

Use o comando gsutil ls para listar o conteúdo no nível superior do intervalo:
```
gsutil ls gs://my-awesome-bucket
```
Se for bem-sucedido, o comando retornará uma mensagem como esta:
```
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 de um objeto

Use o comando gsutil ls com a sinalização -l para ver alguns detalhes sobre um objeto:
```
gsutil ls -l gs://my-awesome-bucket/kitten.png
```
Se for bem-sucedido, o comando retornará uma mensagem como esta:
```
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 o objeto acessível ao público

Use o comando gsutil acl ch para conceder a todos os usuários permissão de leitura para o objeto armazenado no seu intervalo:
```
gsutil acl ch -u AllUsers:R gs://my-awesome-bucket/kitten.png
```
Se funcionar, o comando retornará:
```
Updated ACL on gs://my-awesome-bucket/kitten.png
```
Agora qualquer um pode acessar seu objeto.
Para remover essa permissão, use o comando:
```
gsutil acl ch -d AllUsers gs://my-awesome-bucket/kitten.png
```
Se funcionar, o comando retornará:
```
Updated ACL on gs://my-awesome-bucket/kitten.png
```
Você removeu o acesso público a este objeto.

Conceder acesso ao intervalo

Use o comando gsutil iam ch para conceder a um endereço de e-mail específico permissão 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.
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

Use o comando gsutil rm para excluir um objeto:
```
gsutil rm gs://my-awesome-bucket/kitten.png
```
Se funcionar, o comando retornará:
```
Removing gs://my-awesome-bucket/kitten.png...
```
Essa cópia do objeto não está mais armazenada no Cloud Storage. No entanto, a cópia feita na pasta just-a-folder/ ainda existe.

Limpeza

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste guia de início rápido, siga estas etapas:

Abra uma janela de terminal, se já não estiver aberta.
Use o rm command da gsutil com a sinalização -r para excluir o intervalo e tudo o que estiver dentro dele:
```
gsutil rm -r gs://my-awesome-bucket
```
Se for bem-sucedido, o comando retornará uma mensagem como esta:
```
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.

A seguir

Siga o guia de início rápido do Cloud Storage usando o Console do Google Cloud.
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 gsutil, como criar intervalo (mb), copiar (cp), listar (ls), lista de controle de acesso (acl), gerenciamento de identidade e acesso (iam) e remover (rm).