Sobre os buckets do Cloud Storage

Nesta página, descrevemos buckets, um recurso do Cloud Storage. Para uma visão geral do funcionamento do Cloud Storage, consulte a visão geral do produto do Cloud Storage.

Buckets

Buckets são contêineres básicos que armazenam seus dados como objetos. 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.

  • Os preços (como cobranças por armazenamento de dados, processamento de dados e transferência de dados de saída de rede) dependem de fatores como o local do bucket e as classes de armazenamento dos objetos contidos nele. Para mais detalhes, consulte Preços do Cloud Storage.

Nomes de bucket

Os nomes dos seus buckets precisam atender aos requisitos a seguir:

  • Nomes de bucket podem conter apenas letras minúsculas, caracteres numéricos, traços (-), sublinhados (_) e pontos (.). Espaços não são permitidos. Precisam ser verificados caso incluam pontos.
  • Nomes de bucket devem começar e terminar com um número ou uma letra.
  • Precisam ter de 3 a 63 caracteres. Ter até 222 caracteres caso incluam pontos, mas cada componente separado por ponto não pode ter mais do que 63 caracteres.
  • Nomes de bucket não podem ser representados como um endereço IP na notação decimal com pontos (por exemplo, 192.168.5.4).
  • Nomes de bucket não podem começar com o prefixo "goog".
  • Não podem conter a palavra "google" ou aproximações dela, como "g00gle".

Exemplos de nomes de bucket

Veja a seguir exemplos de nomes de buckets válidos:

Veja a seguir exemplos de nomes de buckets inválidos:

  • My-Travel-Maps (contém letras maiúsculas)
  • my_google_bucket (contém "google")
  • test bucket (contém um espaço)

Considerações sobre nomes de bucket

  • Os nomes dos buckets residem em um único namespace que é compartilhado por todos os usuários do Cloud Storage. O que isso significa:

    • Todos os nomes de buckets precisam ser exclusivos.

      Se você tentar criar um bucket com um nome que já pertence a outro, como example-bucket, o Cloud Storage responderá com uma mensagem de erro.

    • os nomes de bucket são visíveis publicamente.

      Não use IDs de usuário, endereços de e-mail, nomes de projetos, números de projetos ou qualquer informação de identificação pessoal (PII, na sigla em inglês) em nomes de buckets, porque qualquer um pode pesquisar a existência de um bucket.

  • Quando um bucket é excluído, qualquer pessoa pode reutilizar o nome dele.

    • O nome de um bucket excluído costuma levar segundos para ser disponibilizado novamente. No entanto, lembre-se do seguinte:

      • Se você excluir o projeto que contém o bucket, que também o exclui efetivamente, o nome dele poderá não ser lançado por semanas ou mais.

      • Se alguém reutilizar o nome do seu bucket, não será possível restaurar o bucket excluído, mesmo que ele tenha a exclusão reversível ativada.

      • Se um novo bucket com o mesmo nome for criado em um local diferente e dentro de 10 minutos da exclusão do bucket antigo, as solicitações feitas para o novo bucket durante esse período de 10 minutos poderão falhar com um erro 404-Bucket Not Found.

      • Se as solicitações passarem pela API XML, as tentativas de criar um intervalo que reutilize um nome em um novo local poderão falhar com um 404-Bucket Not Found erro por até 10 minutos depois exclusão do bucket antigo.

    • Se alguém reutilizar o nome do seu bucket, poderá receber dados ou solicitações destinados ao bucket excluído original. Para reduzir esse risco, considere as práticas recomendadas a seguir:

      • Ao criar buckets, use uma convenção de nomenclatura forte que não seja fácil de adivinhar ou prever.

      • Ao excluir buckets, remova todas as referências do nome do bucket excluído, como documentação externa ou repositórios de código aberto.

      • Se você não precisar mais de um bucket, considere esvaziar todos os objetos dele e manter o bucket em vez de excluí-lo.

  • É possível usar um nome de bucket em um registro DNS como parte de um CNAME ou A redirecionamento.

    Para isso, o nome do bucket precisa estar em conformidade com as convenções de nomenclatura de DNS padrão. Isso significa que o nome do bucket não pode usar sublinhados (_) ou ter um ponto ao lado de outro ponto ou traço. Por exemplo, .., -. e .- são combinações de caracteres inválidas nos nomes DNS.

Acessar dados em buckets usando pastas ou diretórios

Embora o Cloud Storage armazene dados não estruturados na forma de objetos, alguns recursos permitem acessar e gerenciar seus dados usando pastas ou diretórios.

Namespace hierárquico

Ao criar buckets, você pode ativar o namespace hierárquico para o bucket, que permite usar pastas para armazenar seus objetos como um sistema de arquivos. Organizar seus objetos em pastas facilita a execução de operações em grandes quantidades de dados, melhorando o desempenho, a consistência e a facilidade de gerenciamento. O uso de buckets com o namespace hierárquico ativado é especialmente benéfico ao trabalhar com cargas de trabalho com uso intensivo de dados e orientadas por arquivos.

Para começar a usar o namespace hierárquico, consulte Criar buckets com o namespace hierárquico ativado.

Cloud Storage FUSE

O Cloud Storage FUSE é um adaptador FUSE que permite ativar e acessar buckets como sistemas de arquivos locais para que os aplicativos possam ler e gravar objetos no seu bucket usando a semântica padrão de sistemas de arquivos. O Cloud Storage FUSE permite armazenar seus dados no Cloud Storage com todos os benefícios do serviço, mantendo a capacidade de acessar esses dados usando o código do aplicativo sem precisar de mudanças.

Para saber como usar o Cloud Storage FUSE, consulte o início rápido do Cloud Storage FUSE.

A seguir