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 Google Cloud, na página do seletor de projetos, clique em Criar para começar a criar um novo projeto do Google Cloud.
-
Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.
- Instale o SDK do Cloud.
Quando solicitado, escolha o projeto que você criou acima.
- Instale o Python 3.8
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 bucket
buckets são os contêineres básicos que armazenam seus dados no Cloud Storage.
Para criar um bucket:
- Abra uma janela de terminal.
Use o comando
gsutil mb
e um nome exclusivo para criar um bucket:gsutil mb -b on -l us-east1 gs://my-awesome-bucket/
Esse comando usa um bucket chamado "my-awesome-bucket". Escolha seu próprio nome de bucket globalmente exclusivo.
Se funcionar, o comando retornará:
Creating gs://my-awesome-bucket/...
Você acabou de criar um bucket para armazenar seus dados!
Creating gs://my-awesome-bucket/... ServiceException: 409 Bucket my-awesome-bucket already exists.
Tente novamente com outro nome de bucket.
Fazer upload de um objeto no bucket
Clique com o botão direito na imagem acima e salve-a em algum lugar do computador, por exemplo, na área de trabalho.
Use o comando
gsutil cp
para copiar a imagem do local em que você a salvou para o bucket 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 bucket.
Faça o download do objeto do seu bucket
Use o comando
gsutil cp
para fazer o download da imagem armazenada no seu bucket 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 bucket.
Copie o objeto para uma pasta no bucket
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
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 a imagem para uma nova pasta no seu bucket.
Liste conteúdos de um bucket ou pasta
Use o comando
gsutil ls
para listar o conteúdo no nível superior do bucket: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 bucket.
Liste detalhes para um objeto
Use o comando
gsutil ls
, com a sinalização-l
para ver alguns detalhes sobre uma de suas imagens: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 obter informações sobre o tamanho e a data de criação da imagem.
Torne os objetos acessíveis publicamente
Use o comando
gsutil iam ch
para conceder a todos os usuários permissão para ler as imagens armazenadas no seu bucket:gsutil iam ch allUsers:objectViewer gs://my-awesome-bucket
O comando será bem-sucedido se nenhum erro for retornado.
Agora qualquer pessoa pode acessar suas imagens.
Para remover este acesso, use o comando:
gsutil iam ch -d allUsers:objectViewer gs://my-awesome-bucket
O comando será bem-sucedido se nenhum erro for retornado.
Você removeu o acesso público às imagens em seu bucket.
Conceder acesso ao bucket
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 bucket: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 bucket.
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 bucket.
Excluir um objeto
Use o comando
gsutil rm
para excluir uma de suas imagens:gsutil rm gs://my-awesome-bucket/kitten.png
Se funcionar, o comando retornará:
Removing gs://my-awesome-bucket/kitten.png...
Essa cópia da imagem não está mais armazenada no Cloud Storage. No entanto, a cópia feita na pasta
just-a-folder/
ainda existe.
Limpar
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 bucket 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 bucket 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 para comandos da gsutil, como fazer bucket (
mb
), copiar (cp
), lista (ls
), gerenciamento de acesso à identidade (iam
) e remover (rm
).