Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 contêineres básicos que armazenam seus dados como objetos.
Tudo o que você armazena no Cloud Storage precisa estar contido em um bucket. É possível usar buckets para organizar seus dados e controlar o acesso a eles, 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.
Não é possível alterar o nome de um intervalo existente. Em vez disso, é possível criar um novo bucket com o nome desejado e mover o conteúdo do bucket antigo para o novo. Consulte
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.
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 erro 404-Bucket Not Found 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 original excluído. Para reduzir esse risco, considere as seguintes práticas recomendadas:
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 ao 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 redirecionamento CNAME ou A.
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 opcionalmente o namespace hierárquico
para o bucket, o que permite usar pastas para armazenar seus objetos em
um sistema de arquivos. Organizar os objetos em pastas facilita
a execução de operações em grandes escalas de dados, melhorando o desempenho, a consistência
e a facilidade de gerenciamento. Usar buckets com namespace hierárquico ativado é
especialmente benéfico ao trabalhar com cargas de trabalho
orientadas a arquivos e com uso intensivo de dados.
O Cloud Storage FUSE é um adaptador FUSE que permite montar 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
fazer mudanças.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 UTC."],[],[],null,["# About Cloud Storage buckets\n\nThis page describes buckets, a resource in Cloud Storage. For a general\noverview of how Cloud Storage works, see the\n[Cloud Storage product overview](/storage/docs/introduction).\n\nBuckets\n-------\n\nBuckets are the basic containers that hold your data as [objects](/storage/docs/objects).\nEverything that you store in Cloud Storage must be contained in a\nbucket. You can use buckets to organize your data and control access to your\ndata, but unlike directories and folders, you cannot nest buckets.\n\n- There is no limit to the number of buckets you can have in a project or\n [location](/storage/docs/locations).\n\n - There are, however, [limits to the rate you can create or delete buckets](/storage/quotas).\n- When you [create a bucket](/storage/docs/creating-buckets), you give it a [globally-unique name](#naming) and a\n [geographic location](/storage/docs/locations) where the bucket and its contents are stored.\n\n - You cannot change the name of an existing bucket. Instead, you can create a new bucket with the name you want and move the contents from the old bucket to the new bucket. See [Move and rename buckets](/storage/docs/moving-buckets) for a step-by-step guide.\n\n\u003c!-- --\u003e\n\n- Pricing (such as charges for data storage, data processing, and network outbound data transfer) depends on factors such as the bucket's location and the storage classes of objects within it. For more details, see [Cloud Storage pricing](/storage/pricing).\n\n\u003c!-- --\u003e\n\n- You can use [Identity and Access Management (IAM)](/storage/docs/access-control/iam) to control access to individual buckets.\n\nBucket names\n------------\n\nYour bucket names must meet the following requirements:\n\n- Bucket names can only contain lowercase letters, numeric characters, dashes (`-`), underscores (`_`), and dots (`.`). Spaces are not allowed. Names containing dots require [verification](/storage/docs/domain-name-verification).\n- Bucket names must start and end with a number or letter.\n- Bucket names must contain 3-63 characters. Names containing dots can contain up to 222 characters, but each dot-separated component can be no longer than 63 characters.\n- Bucket names cannot be represented as an IP address in dotted-decimal notation (for example, 192.168.5.4).\n- Bucket names cannot begin with the \"goog\" prefix.\n- Bucket names cannot contain \"google\" or close misspellings, such as \"g00gle\".\n\n### Example bucket names\n\nThe following are examples of valid bucket names:\n\n- `my-travel-maps`\n- `0f75d593-8e7b-4418-a5ba-cb2970f0b91e`\n- `test.example.com` (Requires [verification of ownership for `example.com`](/storage/docs/domain-name-verification))\n\nThe following are examples of invalid bucket names:\n\n- `My-Travel-Maps` (contains uppercase letters)\n- `my_google_bucket` (contains \"google\")\n- `test bucket` (contains a space)\n\n### Bucket name considerations\n\n- Bucket names reside in a single namespace that is shared by all\n Cloud Storage users. This means that:\n\n - Every bucket name must be globally unique.\n\n If you try to create a bucket with a name that already belongs to an\n existing bucket, such as `example-bucket`, Cloud Storage\n responds with an error message.\n - Bucket names are publicly visible.\n\n Don't use user IDs, email addresses, project names, project numbers, or\n any personally identifiable information (PII) in bucket names because\n anyone can probe for the existence of a bucket.\n- Once you delete a bucket, anyone can reuse its name for a new bucket.\n\n - The time it takes a deleted bucket's name to become available again is\n typically on the order of seconds; however, keep in mind the following:\n\n - If you delete the project that contains the bucket, which effectively\n deletes the bucket as well, the bucket name may not be released for weeks\n or longer.\n\n - If someone reuses your bucket's name, you cannot restore your deleted\n bucket even if the bucket has soft delete enabled.\n\n - If a new bucket with the same name is created in a different location and\n within 10 minutes of the old bucket's deletion, requests made to the new\n bucket during this 10 minute timeframe might fail with a\n `404-Bucket Not Found` error.\n\n - If your requests go through the [XML API](/storage/docs/xml-api), attempts to create a bucket\n that reuses a name in a new location might fail with a\n `404-Bucket Not Found` error for up to 10 minutes after the old bucket's\n deletion.\n\n - If someone reuses your bucket's name, they could inadvertently\n receive data or requests intended for your original deleted bucket. To\n mitigate this risk, consider the following best practices:\n\n - When creating buckets, use a strong naming convention that's not easy to\n guess or predict.\n\n - When deleting buckets, make sure to remove all references of the\n deleted bucket's name, such as from external documentation or open\n source repositories.\n\n - If you no longer need a bucket, consider emptying all objects from\n the bucket and keeping the bucket instead of deleting it.\n\n- You can use a bucket name in a DNS record as part of a `CNAME` or `A`\n redirect.\n\n In order to do so, your bucket name should conform to standard DNS naming\n conventions. This means that your bucket name shouldn't use underscores\n (`_`) or have a period next to another period or dash. For example, `..`,\n `-.`, and `.-` are invalid character combinations within DNS names.\n\nAccess data in buckets by using folders or directories\n------------------------------------------------------\n\nAlthough Cloud Storage stores unstructured data in the form of objects,\nsome features let you access and manage your data using folders or directories.\n\n### Hierarchical namespace\n\nWhen you create buckets, you can optionally enable [hierarchical namespace](/storage/docs/hns-overview)\nfor the bucket, which lets you use [folders](/storage/docs/folders-overview) to store your objects in\na file system manner. Organizing your objects into folders makes it easier to\nrun operations on large scales of data, improving performance, consistency,\nand ease of management. Using buckets with hierarchical namespace enabled is\nespecially beneficial when working with data-intensive and file-oriented\nworkloads.\n\nTo get started using hierarchical namespace, see\n[Create buckets with hierarchical namespace enabled](/storage/docs/create-hns-bucket).\n\n### Cloud Storage FUSE\n\n[Cloud Storage FUSE](/storage/docs/cloud-storage-fuse/overview#overview) is a FUSE adapter that lets you mount and access buckets as\nlocal file systems, so applications can read and write objects in your bucket\nusing standard file system semantics. Cloud Storage FUSE lets you store your data\nin Cloud Storage with all the service's benefits, all while retaining\nthe ability to access that data using your application's code without needing\nchanges.\n\nTo learn how to use Cloud Storage FUSE, see the [Cloud Storage FUSE quickstart](/storage/docs/cloud-storage-fuse/quickstart-mount-bucket).\n\nWhat's next\n-----------\n\n- [Create Cloud Storage buckets](/storage/docs/creating-buckets).\n- [Rename an existing bucket](/storage/docs/moving-buckets).\n- Learn about the [metadata associated with a bucket](/storage/docs/bucket-metadata).\n- [Upload an object](/storage/docs/uploading-objects)."]]
