Termos-chave

Para usar o Cloud Storage efetivamente, você precisa entender alguns dos conceitos da criação dele. Neste documento, você tem uma visão geral dos termos e conceitos importantes usados no Cloud Storage.

Para uma introdução ao uso do Cloud Storage, consulte O que é o Cloud Storage?.

Projetos

Todos os dados no Cloud Storage pertencem a um projeto. Um projeto consiste em um conjunto de usuários, um conjunto de APIs e configurações de faturamento, autenticação e monitoramento dessas APIs. É possível ter um ou vários projetos.

Buckets

Buckets são os recipientes básicos que armazenam seus dados. Tudo o que você armazena no Cloud Storage precisa estar contido em um bucket. Você pode usar buckets para armazenar e controlar o acesso a seus dados, mas, ao contrário de diretórios e pastas, não é possível aninhar buckets. Não há limite para a quantidade de buckets em um projeto ou local, mas há limites para a frequência em que você pode criar ou excluir buckets.

Ao criar um bucket, você fornece a ele um nome exclusivo globalmente e um local geográfico em que o bucket e o conteúdo são armazenados. Não é possível alterar o nome e o local do bucket após a criação, mas é possível excluir e recriar o bucket para ter um resultado semelhante. Há também as configurações opcionais de bucket que podem ser definidas durante a criação do bucket e alteradas mais tarde.

Objetos

Objetos são os dados individuais que você armazena no Cloud Storage. Não há limite no número de objetos que podem ser criados em um bucket.

Os objetos têm dois componentes: dados e metadados. Os dados de objeto geralmente são um arquivo que você quer armazenar no Cloud Storage e é completamente opaco no Cloud Storage. Metadados de objeto são uma coleção de pares de nome-valor que descrevem várias qualidades de objeto.

Nomes de objeto

O nome de um objeto é tratado como uma parte de metadados de objeto no Cloud Storage. Os nomes de objetos podem conter qualquer combinação de caracteres Unicode (codificados em UTF-8), precisam ter menos de 1.024 bytes e ser exclusivos em um intervalo.

O Cloud Storage usa um namespace flat para armazenar objetos, ou seja, o Cloud Storage vê todos os objetos de um determinado bucket como independentes, sem qualquer relacionamento hierárquico. Por conveniência, ferramentas como Console do Google Cloud e gsutil trabalham com objetos que usam o caractere de barra (/) como se estivessem armazenados em uma hierarquia virtual.

Por exemplo, é possível nomear um objeto como /europe/france/paris.jpg e outro como /europe/france/cannes.jpg. Ao usar o console do Google Cloud, é possível navegar até esses objetos como se eles estivessem em uma estrutura hierárquica de diretórios nas pastas europe e france.

Para mais informações, incluindo como renomear um objeto, consulte as diretrizes de nomenclatura de objeto.

Imutabilidade do objeto

Os objetos são imutáveis, o que significa não é possível alterar um objeto enviado durante toda a vida útil de armazenamento dele. A vida útil de armazenamento de um objeto é o tempo entre a criação bem-sucedida do objeto, como upload e exclusão do objeto. Na prática, isso significa que não é possível fazer alterações incrementais aos objetos, como operações de anexo ou de truncagem. No entanto, é possível substituir objetos armazenados no Cloud Storage. Isso acontece atomicamente: até que o novo upload seja concluído, a versão antiga do objeto é exibida aos leitores. Depois da conclusão do upload, a nova versão do objeto é exibida aos leitores. Portanto, uma única operação de substituição simplesmente marca o final do ciclo de vida de um objeto imutável e o início do ciclo de vida de um novo objeto imutável.

O número de geração de um objeto é alterado sempre que você substitui os dados desse objeto. Assim, o número de geração identifica exclusivamente um objeto imutável.

Há um limite de uma vez por segundo para substituir rapidamente o mesmo objeto. A substituição do mesmo objeto com mais frequência pode resultar em erros 429 Too Many Requests. Projete o aplicativo para fazer upload de dados de um objeto específico no máximo uma vez por segundo e para processar erros 429 Too Many Requests ocasionais usando a espera exponencial truncada.

Recursos

Um recurso é uma entidade no Google Cloud. Cada projeto, bucket e objeto no Google Cloud é um recurso, assim como instâncias do Compute Engine .

Nomes de recursos

Cada recurso tem um nome único que o identifica, muito parecido com um nome de arquivo. Os buckets têm um nome de recurso no formato projects/_/buckets/BUCKET_NAME, em que BUCKET_NAME é o ID do bucket. Os objetos têm um nome de recurso no formato projects/_/buckets/BUCKET_NAME/objects/OBJECT_NAME, em que OBJECT_NAME é o ID do objeto.

Um #NUMBER anexado ao final do nome do recurso indica uma geração específica do objeto. #0 é um identificador especial da versão mais recente do objeto. É útil adicionar o identificador #0 quando o nome do objeto termina em uma string que, de outra forma, seria interpretada como um número de geração.

Uso da rede

O uso da rede representa os dados enviados ou recebidos do Cloud Storage.

A saída representa os dados enviados do Cloud Storage nas respostas HTTP. Os dados ou a leitura de metadados de um bucket do Cloud Storage são um exemplo de saída.

A entrada representa os dados enviados do Cloud Storage nas solicitações HTTP. Os dados ou os metadados gravados em um bucket do Cloud Storage são um exemplo de entrada.

Para mais informações, consulte Preços do Cloud Storage e Cotas do Cloud Storage.

A seguir

Faça um teste

Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho do Cloud Storage em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

Faça uma avaliação gratuita do Cloud Storage