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 memberikan ringkasan tentang berbagai jenis folder di Cloud Storage, dengan fokus pada cara folder berfungsi dalam bucket saat namespace hierarkis diaktifkan.

Jenis folder

Di Cloud Storage, ada tiga jenis folder utama:

  • Folder simulasi: Bucket Cloud Storage standar mengatur objek dalam 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 simulasi, lihat Folder simulasi.

  • Folder: Di 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 mencantumkan folder. Operasi pengelolaan folder dan struktur hierarkis meningkatkan performa, konsistensi, dan pengelolaan untuk beban kerja yang berorientasi pada file dan intensif data.

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

Ringkasan folder

Folder ada sebagai resource di bucket dengan namespace hierarkis yang diaktifkan. Anda dapat mengatur objek dalam folder dalam struktur seperti 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. Untuk 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 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.

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 nama dengan garis miring di awal, akhir (/), atau garis miring berturut-turut. 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.txt Setiap bucket menyertakan folder root. Objek foo.txt berada di folder root bucket.
    dir1/foo.txt Objek foo.txt berada dalam folder tingkat teratas bernama dir1/. 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 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 yang diaktifkan mendukung kedalaman folder maksimum 50. Akibatnya, nama objek tidak boleh memiliki lebih dari 50 garis miring (/).

  • Ukuran maksimum nama folder: 512 byte (enkode UTF-8).

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

Langkah selanjutnya

Coba sendiri

Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa Cloud Storage dalam skenario dunia nyata. Pelanggan baru mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

Coba Cloud Storage gratis