Termos importantes

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 Guia de início rápido sobre como usar o Console.

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.

Intervalos

Intervalos são os contêineres básicos que armazenam os dados. Tudo o que você armazena no Cloud Storage precisa estar contido em um intervalo. É possível usar intervalos para armazenar e controlar o acesso a seus dados, mas, ao contrário de diretórios e pastas, não é possível aninhar intervalos. Como há limites para a criação e a exclusão de intervalos, projete seus aplicativos de armazenamento para realizar mais operações com objetos e relativamente poucas operações com intervalos.

Ao criar um intervalo, você especifica um nome globalmente único, um local geográfico em que o intervalo e o conteúdo são armazenados e uma classe de armazenamento padrão. A classe de armazenamento padrão escolhida se aplica aos objetos adicionados ao intervalo que não têm uma classe de armazenamento especificada explicitamente.

Depois de criar um intervalo, ainda é possível alterar a classe de armazenamento padrão para qualquer classe compatível com o local do intervalo. No entanto, só é possível alterar o nome e o local excluindo e recriando o intervalo.

Nomes de intervalo

Nomes de intervalo têm mais restrições do que nomes de objetos e precisam ser exclusivos globalmente, porque cada intervalo reside em um único namespace do Cloud Storage. Além disso, os nomes de intervalo podem ser usados com um redirecionamento CNAME o que significa que precisam atender às convenções de nomenclatura de DNS. Para mais informações, consulte as diretrizes de nomenclatura de intervalo.

Rótulos de intervalos

Os rótulos de intervalo são pares de metadados de chave-valor que permitem agrupar seus intervalos com outros recursos do Google Cloud Platform, como instâncias de máquina virtual e discos permanentes. Por exemplo, é possível usar rótulos para criar uma chave team com os valores alpha, beta e delta, e depois aplicar os rótulos team:alpha, team:beta e team:delta a intervalos diferentes para indicar qual equipe está associada a cada um deles.

É possível aplicar vários rótulos a cada intervalo até o máximo de 64 rótulos por intervalo.

  • Cada chave e valor não pode ter mais de 63 caracteres.
  • Chaves e valores podem conter apenas letras minúsculas, caracteres numéricos, sublinhados e travessões. Caracteres internacionais são permitidos.
  • As chaves dos rótulos precisam começar com uma letra minúscula. É permitido usar caracteres internacionais.
  • As chaves do rótulo não podem estar vazias.

Para um exemplo geral de uso de rótulos para organizar seus recursos no faturamento, consulte Exemplos de consulta de exportação de faturamento para o BigQuery.

Objetos

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

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. 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 objeto podem conter qualquer combinação de caracteres Unicode (codificados em UTF-8) e precisam ter menos de 1.024 bytes de tamanho.

Um caractere comum que pode ser incluído em nomes de objetos é uma barra (/). Usar barras faz com que os objetos pareçam estar armazenados em uma estrutura hierárquica. Por exemplo, é possível nomear um objeto como /europe/france/paris.jpg e outro como /europe/france/cannes.jpg. Quando você lista esses objetos, eles parecerão estar em uma estrutura de diretórios hierárquica com base no local. No entanto, o Cloud Storage vê os objetos como entidades independentes, sem qualquer relacionamento hierárquico.

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

Versões e números de geração de objetos

Um objeto no Cloud Storage pode ter versões diferentes: por padrão, quando você substitui um objeto, o Cloud Storage exclui a versão antiga e a substitui por uma nova versão. Quando você ativa o recurso de controle de versões de objetos no seu intervalo, as versões mais antigas permanecem intervalo mesmo depois de uma substituição ou exclusão.

Cada versão de objeto é identificada de maneira única por um número de geração, encontrado nos metadados do objeto. Depois do controle de versões de objetos ter criado uma versão mais antiga de um objeto, é possível usar o número de geração para fazer referência à versão mais antiga. Isso permite que você restaure um objeto substituído no seu intervalo ou exclua permanentemente as versões mais antigas do objeto que não são mais necessárias. Os números de geração também são usados para incluir condições prévias nas solicitações.

Recursos

Um recurso é uma entidade no Google Cloud Platform. Cada projeto, intervalo e objeto no Google Cloud Platform é 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 intervalos têm nome de recurso no formato projects/_/buckets/[BUCKET_NAME], em que [BUCKET_NAME] é o ID do intervalo. Os objetos têm 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 e #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.

Redundância geográfica

Os dados com redundância geográfica são armazenados de maneira redundante em pelo menos dois locais geográficos diferentes, separados por pelo menos 160 km. Objetos armazenados em locais birregionais e multirregionais têm redundância geográfica independentemente da classe de armazenamento.

A redundância geográfica ocorre de modo assíncrono, mas todos os dados do Cloud Storage são redundantes em pelo menos um local geográfico assim que você faz o upload.

A redundância geográfica garante a máxima disponibilidade dos dados, mesmo no caso de interrupções em larga escala, como desastres naturais. Em locais birregionais, a redundância geográfica é fruto do uso de duas regiões específicas. Em locais multirregionais, a redundância geográfica é fruto de qualquer combinação de data centers dentro do local multirregional especificado, podendo incluir aqueles que não estão explicitamente listados como regiões disponíveis.

Opacidade dos dados

Um componente de dados de um objeto é completamente opaco para o Cloud Storage. É apenas um fragmento de dados para o Cloud Storage.

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 (upload) e sua exclusão bem-sucedida. 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 sobrescrever objetos armazenados no Cloud Storage, e isso acontece atomicamente, até que o novo upload seja concluído. A versão antiga do objeto será exibida aos leitores e, depois que o upload for concluído, a nova versão do objeto será disponibilizada 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.

Não há limite para a frequência com que é possível criar ou atualizar objetos diferentes em um intervalo. No entanto, um determinado objeto pode ser atualizado ou substituído apenas uma vez por segundo. Por exemplo, se você tiver um objeto bar no intervalo foo, será possível enviar uma nova cópia de foo/bar cerca de uma vez por segundo. Atualizar o mesmo objeto com mais frequência do que uma vez por segundo pode resultar em erros 429 Too Many Requests.

Repita as solicitações que apresentaram falha usando a espera exponencial truncada.

Hierarquia

O Google Cloud Storage usa um namespace simples para armazenar objetos. No entanto, algumas ferramentas, como o Console do Google Cloud Platform e a gsutil, podem funcionar com objetos como se eles estivessem armazenados em uma hierarquia virtual, por conveniência.

namespace

Há apenas um namespace do Cloud Storage, o que significa que cada intervalo precisa ter um nome exclusivo em todo o namespace do Cloud Storage. Os nomes de objeto precisam ser únicos apenas dentro de um determinado intervalo.

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

Enviar comentários sobre…

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