Tentang folder dalam bucket dengan namespace hierarkis yang diaktifkan

Halaman ini memberikan informasi tentang folder di bucket dengan namespace hierarkis diaktifkan.

Ringkasan

Saat Anda membuat bucket dengan namespace hierarkis diaktifkan, bucket akan 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 dengan lebih efektif dan mendapatkan akses ke kemampuan direktori yang sebenarnya, seperti penggantian nama folder atomik dan operasi metadata yang efisien.

Anda dapat mengelola folder menggunakan operasi buat, hapus, ganti nama, cantumkan, dan dapatkan. Untuk mempelajari cara melakukan operasi ini, lihat Membuat dan mengelola folder dan Mengganti nama folder.

Folder di bucket dengan namespace hierarkis 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 diaktifkan. Folder terkelola terutama digunakan untuk memberikan izin IAM ke grup objek. Untuk mengetahui informasi selengkapnya tentang jenis folder lainnya ini, lihat Jenis folder.

Metadata folder

Metadata folder berisi informasi terstruktur tentang folder. 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. Misalnya, my-bucket.
  • id: ID unik untuk folder dalam bucket. Misalnya, hns-bucket/dir1/.
  • kind: Jenis resource. Untuk folder, nilai ini selalu storage#folder.
  • name: Nama folder. Misalnya, dir1/.
  • selfLink: URL yang mereferensikan folder di Cloud Storage API.
  • timeCreated: Stempel waktu saat folder dibuat. Misalnya, 2023-05-05T16:32:08.878000+00:00.
  • updated: Stempel waktu saat folder terakhir diperbarui. Misalnya, 2024-05-06T16:32:08.878000+00:00.

Operasi folder

Bagian ini menjelaskan operasi yang dapat Anda lakukan pada folder.

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, 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 mencantumkan folder. Karena folder adalah resource yang berbeda di bucket dengan namespace hierarkis diaktifkan, operasi ini mengevaluasi struktur folder yang sebenarnya, bukan mensimulasikan folder dari jalur objek.

Saat mencantumkan folder, Anda dapat memfilter hasil menggunakan parameter seperti prefix, delimiter, lexicographicStart, dan lexicographicEnd. Misalnya, menetapkan parameter pemisah ke / memungkinkan Anda mencantumkan folder dalam mode seperti direktori, hanya menampilkan folder yang cocok dengan awalan atau ada satu tingkat di bawahnya.

Operasi mencantumkan folder menampilkan hasil yang diberi nomor halaman. Satu halaman respons dapat berisi maksimal 1.000 folder.

Mendapatkan metadata folder

Anda dapat mengambil properti folder menggunakan operasi mendapatkan metadata folder. 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 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 dasar yang sama. Operasi ini adalah perubahan atomik dan hanya metadata yang memperbarui jalur folder tanpa menyalin atau menghapus objek dasar secara fisik. Mengganti nama folder juga memperbarui jalur folder untuk resource dalam folder, seperti folder turunan, objek, dan folder terkelola. Hal ini membuat operasi menjadi cepat dan menghindari biaya salinan objek.

Di JSON API dan Google Cloud CLI, penggantian nama dan pemindahan menggunakan endpoint atau perintah URL yang sama. Di Google Cloud konsol, Ganti nama folder dan Pindahkan folder ditampilkan sebagai dua opsi yang berbeda, tetapi opsi tersebut menjalankan operasi backend yang sama.

Selama operasi penggantian nama folder, Anda dapat membaca dan mencantumkan folder yang diganti namanya, tetapi Anda tidak dapat menjalankan operasi tulis di folder tersebut.

Operasi penggantian nama folder memulai operasi yang berjalan lama.

Menghapus folder

Anda dapat menghapus folder kosong secara permanen menggunakan operasi menghapus folder. Meskipun folder dapat dibuat secara otomatis selama operasi objek, folder tidak akan otomatis dihapus saat kosong. Anda harus menghapusnya secara eksplisit.

Jika Anda menghapus folder yang memiliki folder terkelola di jalur yang sama, folder terkelola juga akan dihapus.

Pertimbangan

Saat membuat folder, pertimbangkan hal berikut:

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

    Nama objek Lokasi dalam 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 atas berbeda dengan folder root.
    dir1/ Garis miring di akhir nama objek seperti dir1/ menunjukkan bahwa objek berada 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 bernama dir1//, folder turunan dari dir1/.

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

  • Ukuran nama folder maksimum: 512 byte (enkode 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 di bucket. Jangan sertakan informasi sensitif atau PII dalam nama folder.

  • Interaksi dengan folder terkelola: Di bucket dengan namespace hierarkis diaktifkan, Anda dapat mengelola kontrol akses menggunakan folder terkelola bersama dengan 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