Halaman ini menjelaskan bucket, yang merupakan 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. Segala sesuatu yang Anda simpan di Cloud Storage harus berada di 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 sebuah project atau lokasi.
Saat membuat bucket, Anda memberinya nama yang unik secara global dan lokasi geografis tempat bucket dan kontennya disimpan.
- Anda tidak dapat mengubah nama atau lokasi bucket yang ada. Sebagai gantinya, Anda dapat membuat bucket baru dengan nama yang diinginkan atau di lokasi yang diinginkan, lalu memindahkan konten dari bucket lama ke bucket baru. Lihat Memindahkan dan Mengganti Nama Bucket untuk panduan langkah demi langkah.
Harga (seperti biaya penyimpanan data, operasi, biaya pengambilan, dan traffic keluar jaringan) bergantung pada faktor-faktor seperti lokasi dan kelas penyimpanan bucket Anda. Untuk mengetahui detail selengkapnya, lihat Harga Cloud Storage.
Nama bucket
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 kesalahan ejaan yang menyerupainya, seperti "g00gle".
Pertimbangan nama bucket
Nama bucket berada dalam 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 oleh bucket yang ada, misalnya
example-bucket
, Cloud Storage akan merespons dengan pesan error.Nama bucket dapat dilihat secara 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 bucket baru dibuat di lokasi berbeda dan dalam waktu 10 menit setelah penghapusan bucket lama, permintaan yang dibuat ke bucket baru selama jangka waktu 10 menit ini mungkin akan 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 Anda menghapus project yang berisi bucket, yang juga secara efektif menghapus bucket, nama bucket mungkin tidak akan dirilis selama berminggu-minggu atau lebih lama.
Anda dapat menggunakan nama bucket dalam Data DNS sebagai bagian dari pengalihan
CNAME
atauA
.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 sebelah titik atau tanda hubung lainnya. Misalnya,..
,-.
, dan.-
adalah kombinasi karakter yang tidak valid dalam nama DNS.
Contoh nama bucket
Berikut ini contoh nama bucket yang valid:
my-travel-maps
0f75d593-8e7b-4418-a5ba-cb2970f0b91e
test.example.com
(Memerlukan verifikasi kepemilikan untukexample.com
)
Berikut adalah contoh nama bucket yang tidak valid:
My-Travel-Maps
(berisi huruf besar)my_google_bucket
(berisi "google")test bucket
(berisi spasi)
Langkah berikutnya
- Membuat bucket Cloud Storage.
- Mengganti nama bucket yang ada.
- Pelajari metadata yang terkait dengan bucket.
- Mengupload objek.