Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menjelaskan bucket, resource dalam Cloud Storage. Untuk ringkasan umum tentang cara kerja Cloud Storage, lihat Ringkasan produk Cloud Storage.
Bucket
Bucket adalah container dasar yang menyimpan data Anda sebagai objek.
Semua yang Anda simpan di Cloud Storage harus berada dalam bucket. Anda dapat menggunakan bucket untuk mengatur data dan mengontrol akses ke data Anda, tetapi berbeda dengan direktori dan folder, Anda tidak dapat membuat bucket yang disusun secara bertingkat.
Tidak ada batasan jumlah bucket yang dapat Anda miliki dalam project atau
lokasi.
Anda tidak dapat mengubah nama bucket yang ada. Sebagai gantinya, Anda dapat membuat bucket baru dengan nama yang diinginkan dan memindahkan konten dari bucket lama ke bucket baru. Lihat
Memindahkan dan mengganti nama bucket untuk mendapatkan panduan langkah demi langkah.
Harga (seperti biaya untuk penyimpanan data, pemrosesan data, dan transfer data keluar jaringan) bergantung pada faktor-faktor seperti lokasi bucket dan kelas penyimpanan objek di dalamnya. Untuk mengetahui detail selengkapnya, lihat
Harga Cloud Storage.
Nama bucket Anda harus memenuhi persyaratan berikut:
Nama bucket hanya boleh berisi huruf kecil, karakter numerik, tanda hubung (-), garis bawah (_), dan titik (.). Tidak diperbolehkan ada spasi.
Nama yang mengandung titik memerlukan verifikasi.
Nama bucket harus diawali dan diakhiri dengan angka atau huruf.
Nama bucket harus berisi 3-63 karakter. Nama yang mengandung titik dapat berisi hingga
222 karakter, tetapi masing-masing komponen yang dipisahkan titik dapat berisi lebih dari 63 karakter.
Nama bucket tidak dapat direpresentasikan sebagai alamat IP dalam notasi desimal bertitik
(misalnya, 192.168.5.4).
Nama bucket tidak boleh dimulai dengan awalan "goog".
Nama bucket tidak boleh berisi "google" atau salah ejaan yang mirip, seperti "g00gle".
Berikut adalah contoh nama bucket yang tidak valid:
My-Travel-Maps (berisi huruf besar)
my_google_bucket (berisi "google")
test bucket (berisi spasi)
Pertimbangan nama bucket
Nama bucket berada di satu namespace yang digunakan bersama oleh semua pengguna Cloud Storage. Hal ini berarti:
Setiap nama bucket harus unik secara global.
Jika Anda mencoba membuat bucket dengan nama yang sudah dimiliki bucket yang ada, seperti example-bucket, Cloud Storage akan merespons dengan pesan error.
Nama bucket dapat dilihat oleh publik.
Jangan menggunakan ID pengguna, alamat email, nama project, nomor project, atau informasi identitas pribadi (PII) dalam nama bucket karena siapa pun dapat memeriksa keberadaan bucket.
Setelah Anda menghapus bucket, semua orang dapat menggunakan kembali nama bucket tersebut untuk bucket baru.
Waktu yang diperlukan agar nama bucket yang dihapus tersedia kembali biasanya dalam hitungan detik; tetapi, perhatikan hal-hal berikut:
Jika Anda menghapus project yang berisi bucket, yang secara efektif
menghapus bucket juga, nama bucket mungkin tidak dirilis selama berminggu-minggu
atau lebih lama.
Jika seseorang menggunakan kembali nama bucket Anda, Anda tidak dapat memulihkan bucket yang dihapus meskipun bucket tersebut mengaktifkan penghapusan sementara.
Jika bucket baru dengan nama yang sama dibuat di lokasi yang berbeda dan dalam waktu 10 menit setelah penghapusan bucket lama, permintaan yang dibuat ke bucket baru selama jangka waktu 10 menit ini mungkin gagal dengan error 404-Bucket Not Found.
Jika permintaan Anda ditangani oleh XML API, upaya untuk membuat bucket
yang menggunakan kembali nama di lokasi baru mungkin akan gagal dengan
error 404-Bucket Not Found hingga 10 menit setelah penghapusan bucket lama.
Jika seseorang menggunakan kembali nama bucket Anda, orang tersebut dapat secara tidak sengaja menerima data atau permintaan yang ditujukan untuk bucket asli Anda yang telah dihapus. Untuk
meminimalkan risiko ini, pertimbangkan praktik terbaik berikut:
Saat membuat bucket, gunakan konvensi penamaan yang kuat yang tidak mudah
ditebak atau diprediksi.
Saat menghapus bucket, pastikan untuk menghapus semua referensi nama bucket yang dihapus, seperti dari dokumentasi eksternal atau repositori open source.
Jika Anda tidak lagi memerlukan bucket, pertimbangkan untuk mengosongkan semua objek dari bucket dan mempertahankan bucket tersebut, bukan menghapusnya.
Anda dapat menggunakan nama bucket dalam Data DNS sebagai bagian dari pengalihan CNAME atau A.
Untuk melakukannya, nama bucket Anda harus sesuai dengan konvensi penamaan DNS standar. Artinya, nama bucket Anda tidak boleh menggunakan garis bawah (_) atau memiliki titik di samping titik lain atau tanda pisah. Misalnya, .., -., dan .- adalah kombinasi karakter yang tidak valid dalam nama DNS.
Mengakses data dalam bucket menggunakan folder atau direktori
Meskipun Cloud Storage menyimpan data tidak terstruktur dalam bentuk objek, beberapa fitur memungkinkan Anda mengakses dan mengelola data menggunakan folder atau direktori.
Namespace hierarkis
Saat membuat bucket, Anda dapat mengaktifkan namespace hierarkis untuk bucket secara opsional, yang memungkinkan Anda menggunakan folder untuk menyimpan objek dengan cara sistem file. Mengatur objek ke dalam folder akan mempermudah
menjalankan operasi pada data dalam skala besar, sehingga meningkatkan performa, konsistensi,
dan kemudahan pengelolaan. Penggunaan bucket dengan ruang nama hierarkis yang diaktifkan sangat bermanfaat saat menangani beban kerja yang intensif data dan berorientasi file.
Cloud Storage FUSE adalah adaptor FUSE yang memungkinkan Anda memasang dan mengakses bucket sebagai sistem file lokal, sehingga aplikasi dapat membaca dan menulis objek di dalam bucket Anda menggunakan semantik sistem file standar. Cloud Storage FUSE memungkinkan Anda menyimpan data di Cloud Storage dengan semua manfaat layanan, sekaligus mempertahankan kemampuan untuk mengakses data tersebut menggunakan kode aplikasi Anda tanpa perlu perubahan.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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)."]]
