Tentang folder

Cloud Storage menawarkan berbagai cara untuk mengatur data Anda, dan folder memainkan peran penting dalam proses ini. Memahami berbagai jenis folder yang tersedia dapat membantu Anda memilih folder yang paling sesuai dengan kebutuhan spesifik Anda.

Halaman ini menyediakan ringkasan tentang berbagai jenis folder di Cloud Storage, dengan fokus pada cara kerja folder dalam bucket saat namespace hierarki diaktifkan.

Jenis folder

Di Cloud Storage, ada tiga jenis folder utama:

• Folder simulasi: Bucket Cloud Storage standar mengatur objek di namespace datar. Dengan menggunakan Konsol Google Cloud dan Google Cloud CLI, Anda dapat menyimulasikan folder yang meniru hierarki file untuk membantu Anda mengatur data di bucket. Untuk mengetahui informasi selengkapnya tentang folder yang disimulasikan, lihat Folder simulasi.

• Folder: Dalam bucket dengan namespace hierarkis yang diaktifkan, Anda dapat membuat folder sebenarnya yang berisi objek atau folder lain. Anda juga dapat melakukan operasi seperti mengganti nama folder dan folder listingan. Struktur hierarki dan operasi pengelolaan folder meningkatkan performa, konsistensi, dan pengelolaan untuk workload berorientasi file dan intensif data.

• Folder terkelola: Folder terkelola memungkinkan Anda menerapkan kontrol akses terperinci ke objek Anda, sehingga meningkatkan keamanan dan kontrol atas data Anda. Anda dapat menggunakan folder terkelola di bucket dengan atau tanpa mengaktifkan namespace hierarkis. Untuk mengetahui informasi selengkapnya tentang folder terkelola, lihat Folder terkelola.

Ringkasan folder

Folder ada sebagai resource dalam bucket dengan namespace hierarkis diaktifkan. Anda dapat mengatur objek di dalam folder dengan struktur yang mirip sistem file. Cloud Storage menyediakan API pengelolaan folder yang memungkinkan operasi seperti membuat, menghapus, mengganti nama, dan mencantumkan folder, serta mengambil metadata folder.

Metadata folder

Metadata folder berisi informasi terstruktur tentang folder tersebut. Untuk mengetahui informasi mendetail tentang metadata folder, lihat resource Folder dalam 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 selalu storage#folder.
• name: Nama folder. Contoh, dir1/.
• selfLink: URL yang merujuk ke 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.

Pertimbangan

Ketika membuat folder, pertimbangkan hal-hal berikut ini:

• Nama objek dan folder: Bucket dengan namespace hierarkis diaktifkan, mendukung semua nama objek yang valid, termasuk nama objek dengan garis miring di awal dan akhir (/) atau garis miring berturut-turut. Setiap garis miring ke depan (/) dalam nama objek mewakili folder. Tabel berikut menunjukkan contoh hubungan antara nama objek dan lokasi terkaitnya dalam hierarki folder:

  Nama objek	Lokasi di hierarki folder
  foo.txt	Setiap bucket menyertakan folder root. Objek foo.txt berada di folder root bucket.
  dir1/foo.txt	Objek foo.txt berada dalam folder tingkat atas bernama dir1/. Folder tingkat teratas berbeda dari folder root.
  dir1/	Garis miring di akhir nama objek seperti dir1/ menunjukkan bahwa objek tersebut berada di dalam folder. Dalam contoh ini, nama objek dir1/ sama dengan nama folder induk dir1/.
  dir1//foo.txt	Objek foo.txt berada di folder tingkat kedua yang bernama dir1//, folder turunan dir1/.

• Kedalaman folder maksimum: Bucket dengan namespace hierarkis diaktifkan mendukung kedalaman folder maksimum sebesar 50. Akibatnya, nama objek tidak boleh memiliki lebih dari 50 garis miring (/).

• Pembuatan folder otomatis: Membuat objek baru akan otomatis membuat folder yang tidak ada dan ditentukan di jalur objek. Misalnya, membuat objek bernama dir1/foo.txt akan otomatis membuat folder dir1/ jika belum ada.

Langkah selanjutnya

• Membuat dan mengelola folder.
• Mengganti nama folder.