Tentang folder dalam bucket dengan namespace hierarkis yang diaktifkan
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini memberikan informasi tentang folder dalam bucket dengan namespace hierarkis diaktifkan.
Ringkasan
Folder ada sebagai resource di bucket dengan namespace hierarkis diaktifkan. Anda dapat mengatur objek dalam folder dengan 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 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 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 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.txt
Setiap bucket mencakup 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 nama folder maksimum: 512 byte (berenkode UTF-8).
Pembuatan folder otomatis: Pembuatan 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.
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 sertakan
informasi sensitif atau PII dalam nama folder.
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.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-18 UTC."],[],[],null,["# About folders in buckets with hierarchical namespace enabled\n\nThis page provides information about folders in buckets with\nhierarchical namespace enabled.\n\nOverview\n--------\n\nFolders exist as a resource in buckets with [hierarchical namespace](/storage/docs/hns-overview)\nenabled. You can organize objects within folders in a file system-like\nstructure. Cloud Storage provides folder management APIs that enable\noperations such as creating, deleting, renaming, and listing folders, as well as\nretrieving folder metadata.\n\nFolder metadata\n---------------\n\nA folder's metadata contains structured information about the folder. For\ndetailed information about folder metadata, see the [`Folder` resource](/storage/docs/json_api/v1/folders#resource) in\nthe Cloud Storage JSON API reference documentation.\n\nThe key components of a folder metadata are as follows:\n\n- `bucket`: The name of the bucket where the folder resides. For example, `my-bucket`.\n- `id`: A unique identifier for the folder within the bucket. For example, `hns-bucket/dir1/`.\n- `kind`: The resource type. For a folder, this value is always `storage#folder`.\n- `name`: The name of the folder. For example, `dir1/`.\n- `selfLink`: A URL that references the folder in the Cloud Storage API.\n- `timeCreated`: The timestamp when the folder was created. For example, `2023-05-05T16:32:08.878000+00:00`.\n- `updated`: The timestamp when the folder was last updated. For example, `2024-05-06T16:32:08.878000+00:00`.\n\nConsiderations\n--------------\n\nWhen creating folders, consider the following:\n\n- **Object and folder names** : Buckets with hierarchical namespace enabled,\n support all valid [object names](/storage/docs/objects#naming), including\n those with leading, trailing slashes (`/`) or consecutive slashes. Each\n forward slash (`/`) in an object name represents a folder.\n The following table shows examples of the relationship between object names\n and their corresponding location in the folder hierarchy:\n\n- **Maximum folder depth** : Buckets with hierarchical namespace enabled\n support a maximum folder depth of 50. As a result, object names cannot have\n more than 50 slashes (`/`).\n\n- **Maximum folder name size**: 512 bytes (UTF-8 encoded).\n\n- **Automatic folder creation** : Creating a new object automatically creates\n any non-existent folders specified in the object's path. For example,\n creating an object named `dir1/foo.txt` automatically creates the folder\n `dir1/` if it doesn't already exist.\n\n- **Sensitive or personally identifiable information (PII)**: Folder names are\n more broadly visible than folder metadata. For example, folder names appear\n in URLs and when listing folders or objects in a bucket. Don't include\n sensitive information or PII in folder names.\n\nWhat's next\n-----------\n\n- [Create and manage folders](/storage/docs/create-folders).\n- [Rename a folder](/storage/docs/rename-hns-folders).\n- [Optimize folder management](/storage/docs/hns-buckets-best-practices#folder-management).\n\nTry it for yourself\n-------------------\n\n\nIf you're new to Google Cloud, create an account to evaluate how\nCloud Storage performs in real-world\nscenarios. New customers also get $300 in free credits to run, test, and\ndeploy workloads.\n[Try Cloud Storage free](https://console.cloud.google.com/freetrial)"]]
