Discover
Get started
Create buckets
Manage buckets
Upload and download objects
Manage objects
Get insights on your stored data
Cache objects
Organize objects
Control data lifecycles
Make requests
Secure data
Monitor data and usage
Protection, backup, and recovery
Mount buckets with Cloud Storage FUSE
Work across products, Clouds, and platforms
Troubleshoot
Stay organized with collections Save and categorize content based on your preferences.
This page describes buckets, a resource in Cloud Storage. For a general overview of how Cloud Storage works, see the Cloud Storage product overview.
BucketsBuckets are the basic containers that hold your data. Everything that you store in Cloud Storage must be contained in a bucket. You can use buckets to organize your data and control access to your data, but unlike directories and folders, you cannot nest buckets.
There is no limit to the number of buckets you can have in a project or location.
When you create a bucket, you give it a globally-unique name and a geographic location where the bucket and its contents are stored.
When you create a bucket, you have the option to enable hierarchical namespace for your bucket. Buckets with hierarchical namespace enabled have an optimized storage structure similar to a file system, organizing objects within a hierarchy of folders. This provides improved performance, consistency, and ease of management, especially for data-intensive and file-oriented workloads. For information about enabling hierarchical namespace, see Create buckets with hierarchical namespace enabled.
Bucket namesYour bucket names must meet the following requirements:
-
), underscores (_
), and dots (.
). Spaces are not allowed. Names containing dots require verification.Bucket names reside in a single namespace that is shared by all Cloud Storage users. This means that:
Every bucket name must be globally unique.
If you try to create a bucket with a name that already belongs to an existing bucket, such as example-bucket
, Cloud Storage responds with an error message.
Bucket names are publicly visible.
Don't use user IDs, email addresses, project names, project numbers, or any personally identifiable information (PII) in bucket names because anyone can probe for the existence of a bucket.
Once you delete a bucket, anyone can reuse its name for a new bucket.
The time it takes a deleted bucket's name to become available again is typically on the order of seconds; however, keep in mind the following:
404-Bucket Not Found
error.404-Bucket Not Found
error for up to 10 minutes after the old bucket's deletion.You can use a bucket name in a DNS record as part of a CNAME
or A
redirect.
In order to do so, your bucket name should conform to standard DNS naming conventions. This means that your bucket name should not use underscores (_
) or have a period next to another period or dash. For example, ..
, -.
, and .-
are invalid character combinations within DNS names.
The following are examples of valid bucket names:
my-travel-maps
0f75d593-8e7b-4418-a5ba-cb2970f0b91e
test.example.com
(Requires verification of ownership for example.com
)The following are examples of invalid bucket names:
My-Travel-Maps
(contains uppercase letters)my_google_bucket
(contains "google")test bucket
(contains a space)Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-04-23 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-23 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.3