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 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 o número de buckets em um projeto ou local.
- No entanto, há limites para a taxa 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 ou o local de um bucket existente. Em vez disso, é possível criar um novo bucket com as propriedades que você quer e mover o conteúdo do bucket antigo para o novo. Consulte Como mover e renomear buckets para um guia passo a passo.
- 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.
- Use o Identity and Access Management (IAM) para controlar o acesso a buckets individuais.
Ativar namespace hierárquico em buckets
Ao criar um bucket, você tem a opção de ativar o namespace hierárquico (visualização) do bucket. Buckets com namespaces hierárquicos habilitados têm uma estrutura de armazenamento otimizada semelhante a um sistema de arquivos, organizando objetos em uma hierarquia de pastas. Isso melhora o desempenho, a consistência e a facilidade de gerenciamento, especialmente para cargas de trabalho com uso intensivo de dados e orientadas a cargas de trabalho. Para informações sobre como ativar namespaces hierárquicos, consulte Criar e gerenciar buckets com namespace hierárquico ativado.
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".
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 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 erro
404-Bucket Not Found
por até 10 minutos depois exclusão do bucket antigo.
É possível usar um nome de bucket em um registro DNS como parte de um redirecionamento
CNAME
ouA
.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.
Exemplos de nomes de bucket
Veja a seguir exemplos de nomes de buckets válidos:
my-travel-maps
0f75d593-8e7b-4418-a5ba-cb2970f0b91e
test.example.com
(requer verificação de propriedade paraexample.com
)
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)
A seguir
- Criar buckets do Cloud Storage
- Renomear um bucket existente.
- Saiba mais sobre os metadados associados a um bucket.
- Faça o upload de um objeto.