Halaman ini memberikan informasi tentang folder dalam bucket dengan namespace hierarkis yang diaktifkan.
Ringkasan
Saat Anda membuat bucket dengan namespace hierarkis yang diaktifkan, bucket tersebut menggunakan struktur sistem file yang sebenarnya, bukan namespace datar standar. Folder ada sebagai resource di bucket dengan namespace hierarkis diaktifkan. Dengan menggunakan folder, Anda dapat mengatur objek secara lebih efektif dan mendapatkan akses ke kemampuan direktori yang sebenarnya, seperti penggantian nama folder atomik dan operasi metadata yang efisien.
Folder dalam bucket dengan namespace hierarkis yang diaktifkan berbeda dengan folder simulasi dan folder terkelola. Folder simulasi ada di bucket namespace datar dan folder terkelola dapat diterapkan di bucket namespace datar dan bucket dengan namespace hierarkis yang diaktifkan. Folder terkelola terutama digunakan untuk memberikan izin IAM ke grup objek. Untuk mengetahui informasi selengkapnya tentang jenis folder lainnya, lihat Jenis folder.
Anda dapat mengelola folder dengan melakukan operasi folder. Untuk mempelajari cara membuat, mencantumkan, dan menghapus folder, serta mendapatkan metadata folder, lihat Membuat dan mengelola folder. Untuk mempelajari cara mengganti nama atau memindahkan folder, lihat Mengganti nama folder.
Metadata folder
Metadata folder berisi informasi terstruktur tentang folder. Untuk mengetahui informasi mendetail tentang metadata folder, lihat resource Folder di dokumentasi referensi Cloud Storage JSON API.
Komponen utama metadata folder adalah sebagai berikut:
bucket: Nama bucket tempat folder berada. Contoh,my-bucket.id: ID unik untuk folder dalam bucket. Contoh,hns-bucket/dir1/.kind: Jenis resource. Untuk folder, nilai ini selalustorage#folder.name: Nama folder. Contoh,dir1/.selfLink: URL yang mereferensikan folder di Cloud Storage API.timeCreated: Stempel waktu saat folder dibuat. Contoh,2023-05-05T16:32:08.878000+00:00.updated: Stempel waktu saat folder terakhir diperbarui. Contoh,2024-05-06T16:32:08.878000+00:00.
Operasi folder
Bagian ini menjelaskan operasi yang dapat Anda lakukan pada folder. Beberapa operasi memulai operasi yang berjalan lama yang dapat Anda pantau untuk terus memantau progres dan status operasi.
Membuat folder
Anda dapat membuat folder secara eksplisit menggunakan operasi pembuatan folder.
Selain itu, saat Anda membuat objek dan menentukan folder yang tidak ada di jalur
objek tersebut, folder induk yang tidak ada akan otomatis dibuat untuk Anda. Misalnya, membuat objek bernama dir1/foo.txt akan otomatis membuat folder dir1/ jika belum ada.
Untuk mengetahui informasi tentang penamaan folder, lihat Pertimbangan.
Mencantumkan folder
Anda dapat mengambil daftar folder di bucket menggunakan operasi daftar folder. Karena folder adalah resource yang berbeda dalam bucket dengan namespace hierarkis yang diaktifkan, operasi ini mengevaluasi struktur folder yang sebenarnya, bukan menyimulasikan folder dari jalur objek.
Saat mencantumkan folder, Anda dapat memfilter hasil menggunakan parameter seperti
prefix, delimiter, lexicographicStart, dan lexicographicEnd. Misalnya, menyetel parameter pembatas ke / memungkinkan Anda mencantumkan folder dalam mode seperti direktori, hanya menampilkan folder yang cocok dengan awalan atau ada satu level di bawahnya.
Operasi list folder menampilkan hasil bernomor halaman. Satu halaman respons dapat berisi maksimum 1.000 folder.
Mendapatkan metadata folder
Anda dapat mengambil properti folder menggunakan operasi get folder metadata. Operasi ini mengambil informasi tentang resource folder itu sendiri, bukan objek yang ada di dalamnya.
Operasi ini menampilkan metadata folder, yang memberikan informasi terstruktur seperti stempel waktu pembuatannya, ID uniknya, dan bucket tempat folder tersebut berada. Untuk mengetahui daftar mendetail properti yang ditampilkan oleh operasi ini, lihat Metadata folder.
Mengganti nama atau memindahkan folder
Mengganti nama folder dan memindahkan folder menggunakan operasi pokok yang sama. Operasi ini adalah perubahan atomik khusus metadata yang memperbarui jalur folder tanpa menyalin atau menghapus objek yang mendasarinya secara fisik. Mengganti nama folder juga akan memperbarui jalur folder untuk resource dalam folder, seperti folder turunan, objek, dan folder terkelola. Hal ini membuat operasi menjadi cepat dan menghindari biaya penyalinan objek.
Operasi penggantian nama folder memulai operasi yang berjalan lama.
Selama operasi penggantian nama folder, Anda dapat membaca dan mencantumkan folder yang diganti namanya, tetapi Anda tidak dapat menjalankan operasi tulis pada folder tersebut.
Di JSON API dan Google Cloud CLI, operasi penggantian nama dan pemindahan menggunakan endpoint atau perintah URL yang sama. Di konsol Google Cloud , Ganti nama folder dan Pindahkan folder ditampilkan sebagai dua opsi yang berbeda, tetapi kedua opsi menjalankan operasi backend yang sama.
Menghapus folder
Anda dapat menghapus folder secara permanen menggunakan operasi hapus folder. Meskipun folder dapat dibuat secara otomatis selama operasi objek, folder tersebut tidak dihapus secara otomatis saat kosong. Anda harus menghapusnya secara eksplisit.
Interaksi antara folder dan folder terkelola terkait
Folder terkelola terkait digunakan untuk mengontrol akses ke folder di bucket dengan ruang nama hierarkis yang diaktifkan. Folder dan folder terkelola terkait berinteraksi dengan cara berikut:
Pembuatan folder: Saat Anda membuat folder terkelola dalam bucket dengan namespace hierarkis diaktifkan, semua folder yang tidak ada di jalur folder tersebut akan dibuat secara otomatis, termasuk folder induk dan folder target sebenarnya (juga dikenal sebagai folder terkait).
Misalnya, Anda membuat bucket dengan namespace hierarkis yang diaktifkan bernama
my-bucket. Jika Anda membuat folder terkelola bernama2025/training-data/di bucket, Cloud Storage akan otomatis membuat folder induk2025/dan folder terkait targettraining-data/di bucket.Penghapusan folder: Saat Anda menghapus folder yang memiliki folder terkelola terkait, Cloud Storage juga akan menghapus folder terkelola terkait tersebut. Hal ini karena saat Anda menghapus folder, Anda menghapus seluruh jalur. Karena jalur tidak lagi ada, folder terkelola terkait dan kebijakan IAM yang dilampirkan padanya akan dihapus. Di bucket dengan namespace hierarkis diaktifkan, folder terkelola tidak dapat ada tanpa folder terkait.
Jika Anda tidak memiliki izin yang diperlukan untuk menghapus folder terkelola yang terkait dengan folder, operasi penghapusan folder akan gagal. Untuk menemukan izin yang diperlukan untuk menghapus folder terkelola, lihat Mendapatkan peran yang diperlukan untuk folder terkelola.
Mengganti nama folder: Saat Anda mengganti nama folder yang memiliki folder terkelola terkait, Cloud Storage juga akan mengganti nama folder terkelola terkait.
Untuk mengetahui informasi tentang persyaratan penamaan untuk folder yang memiliki folder terkelola terkait, lihat Penamaan untuk folder.
Pertimbangan
Saat membuat folder, pertimbangkan hal-hal berikut:
Nama objek dan folder: Bucket dengan namespace hierarkis yang diaktifkan mendukung semua nama objek yang valid, termasuk yang memiliki garis miring di awal, di akhir (
/), atau garis miring berurutan. Setiap garis miring (/) dalam nama objek mewakili folder. Tabel berikut menunjukkan contoh hubungan antara nama objek dan lokasinya yang sesuai dalam hierarki folder:Nama objek Lokasi dalam hierarki folder foo.txtSetiap bucket mencakup folder root. Objek foo.txtberada di folder root bucket.dir1/foo.txtObjek foo.txtberada dalam folder tingkat teratas bernamadir1/. Folder tingkat teratas berbeda dengan folder root.dir1/Garis miring di akhir nama objek seperti dir1/menunjukkan bahwa objek berada dalam folder. Dalam contoh ini, nama objekdir1/sama dengan nama folder indukdir1/.dir1//foo.txtObjek foo.txtberada di folder tingkat kedua bernamadir1//, folder turunan daridir1/.Kedalaman folder maksimum: Bucket dengan namespace hierarkis yang diaktifkan mendukung kedalaman folder maksimum 50. Folder dapat dibuat dengan maksimal 50 folder turunan bertumpuk (misalnya,
folder1/folder2/folder3/.../folder50/my-data.txt). Namun, jika folder memiliki folder terkelola terkait, folder tersebut hanya dapat memiliki maksimal 15 folder turunan bertumpuk.Ukuran maksimum nama folder: 512 byte (berenkode UTF-8).
Informasi identitas pribadi (PII) atau sensitif: Nama folder terlihat lebih luas daripada metadata folder. Misalnya, nama folder muncul di URL dan saat mencantumkan folder atau objek dalam bucket. Jangan menyertakan informasi sensitif atau PII dalam nama folder.
Langkah berikutnya
Coba sendiri
Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa Cloud Storage dalam skenario dunia nyata. Pelanggan baru juga akan mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
Coba Cloud Storage gratis