Termos importantes

Para usar o Cloud Storage efetivamente, você precisa entender alguns dos conceitos da criação dele. Nesse documento, apresentamos 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 é composto por um conjunto de usuários, um conjunto de APIs e configurações de faturamento, autenticação e monitoramento para essas APIs. É possível ter um projeto ou vários projetos.

Intervalos

Intervalos são os recipientes básicos que armazenam seus 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 favorecer operações intensivas de objetos e relativamente poucas operações de intervalos.

Ao criar um intervalo, você especifica um nome globalmente exclusivo, 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 junto com outros recursos do Google Cloud Platform, como instâncias de máquina virtual e discos permanentes. Por exemplo, use rótulos para criar uma chave de team com valores alpha, beta e delta e aplicar os rótulos de team:alpha, team:beta e team:delta a diferentes intervalos para indicar que equipe está associada esses intervalos.

Aplique vários rótulos a cada intervalo, com um máximo de 64 rótulos por intervalo.

  • Chaves e valores não podem 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 que você crie 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 1024 bytes de comprimento.

Um caractere comum para incluir em nomes de objetos é uma barra (/). Ao usar barras, faça com que os objetos apareçam como se estivessem armazenados em uma estrutura hierárquica. Por exemplo, nomeie um objeto como /europe/france/paris.jpg e outro como /europe/france/cannes.jpg. Quando você lista esses objetos, eles podem estar em uma estrutura de diretórios hierárquica com base no local. No entanto, o Cloud Storage vê os objetos como independentes, sem qualquer relacionamento hierárquico.

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

Números de geração

Um número de geração é um número associado a cada objeto. Cada vez que o objeto é sobrescrito, o número de geração do objeto é alterado. Quando seu intervalo contém várias versões do mesmo objeto, como quando o controle de versão do objeto está ativado, use o número de geração para referir-se a versões específicas.

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 exclusivo que o identifica, muito parecido com um nome de arquivo. Os intervalos têm um nome de recurso na forma projects/_/buckets/[BUCKET_NAME], em que [BUCKET_NAME] é o código do intervalo. Os objetos têm um nome de recurso na forma projects/_/buckets/[BUCKET_NAME]/objects/[OBJECT_NAME], em que [OBJECT_NAME] é o código do objeto.

Um #[NUMBER] anexado ao final do nome do recurso indica uma geração específica do objeto. #0 é um identificador especial para a versão mais recente de um objeto. #0 é útil para adicionar 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 que são redundantes geograficamente são armazenados de maneira redundante em pelo menos dois locais geográficos diferentes, separados por pelo menos 160 km. Objetos armazenados em locais multirregionais são geo-redundantes, 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 de seus dados, mesmo no caso de interrupções em larga escala, como desastres naturais. Para uma localização com duas regiões, a redundância geográfica é possível usando dois locais regionais específicos. Para outros locais multirregionais, a redundância geográfica é possível usando qualquer combinação de data centers dentro da região multirregional especificada, que pode incluir data centers que não estejam explicitamente disponíveis como locais regionais.

Opacidade de dados

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

Imutabilidade de 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 operação única de substituição marca o final da vida útil de um objeto imutável e o início da vida útil de um novo objeto imutável.

Não há limite para a rapidez com que você pode criar ou atualizar diferentes objetos em um intervalo. No entanto, um único objeto específico pode ser atualizado ou sobregravado até uma vez por segundo. Por exemplo, se você tem um objeto bar no intervalo foo, faça o upload de uma nova cópia do foo/bar apenas uma vez por segundo. Atualizar o mesmo objeto mais rápido do que uma vez por segundo pode resultar em erros 429 Too Many Requests.

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

Hierarquia

O Google Cloud Storage usa um namespace simples para armazenar objetos No entanto, algumas ferramentas (por exemplo, o Console do Google Cloud Platform e a gsutil) podem funcionar com objetos como se 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. Nomes de objeto precisam ser exclusivos 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.