本頁面提供已啟用階層式命名空間的 bucket 中資料夾的相關資訊。
總覽
啟用階層式命名空間後建立 bucket 時,bucket 會使用真正的檔案系統結構,而非標準的扁平命名空間。啟用階層命名空間後,資料夾會以資源形式存在於 bucket 中。 使用資料夾可更有效率地整理物件,並存取真正的目錄功能,例如重新命名不可分割的資料夾,以及執行有效率的中繼資料作業。
您可以使用建立、刪除、重新命名、列出和取得等作業來管理資料夾。如要瞭解如何執行這些作業,請參閱「建立及管理資料夾」和「重新命名資料夾」。
啟用階層命名空間的 bucket 中的資料夾,與模擬資料夾和受管理資料夾不同。模擬資料夾存在於平面命名空間 bucket 中,而管理資料夾則可套用至平面命名空間 bucket 和啟用階層命名空間的 bucket。代管資料夾主要用於授予物件群組 IAM 權限。如要進一步瞭解其他資料夾類型,請參閱「資料夾類型」。
資料夾中繼資料
資料夾的中繼資料包含資料夾的結構化資訊。如要詳細瞭解資料夾中繼資料,請參閱 Cloud Storage JSON API 參考文件中的 Folder 資源。
資料夾中繼資料的主要元件如下:
bucket:資料夾所在的 bucket 名稱。例如:my-bucket。id:bucket 中資料夾的專屬 ID。例如:hns-bucket/dir1/。kind:資源類型。如果是資料夾,這個值一律為storage#folder。name:資料夾名稱。例如:dir1/。selfLink:參照 Cloud Storage API 中資料夾的網址。timeCreated:資料夾的建立時間戳記。例如:2023-05-05T16:32:08.878000+00:00。updated:資料夾上次更新的時間戳記。例如:2024-05-06T16:32:08.878000+00:00。
注意事項
建立資料夾時,請注意下列事項:
物件和資料夾名稱:啟用階層式命名空間的 bucket 支援所有有效的物件名稱,包括開頭、結尾或連續出現斜線 (
/) 的名稱。物件名稱中的每個正斜線 (/) 都代表一個資料夾。下表列出物件名稱與資料夾階層中對應位置的關係範例:物件名稱 資料夾階層中的位置 foo.txt每個 bucket 都包含根資料夾。物件 foo.txt位於值區的根資料夾下。dir1/foo.txt物件 foo.txt位於名為dir1/的頂層資料夾中。頂層資料夾與根資料夾不同。dir1/物件名稱結尾的斜線 (例如 dir1/) 表示物件位於資料夾內。在本例中,物件名稱dir1/與父項資料夾名稱dir1/相同。dir1//foo.txt物件 foo.txt位於名為dir1//的第二層資料夾中,這是dir1/的子資料夾。資料夾深度上限:啟用階層命名空間的 bucket 最多支援 50 個資料夾深度。因此,物件名稱不得超過 50 個斜線 (
/)。資料夾名稱大小上限:512 個位元組 (UTF-8 編碼)。
自動建立資料夾:建立新物件時,系統會自動建立物件路徑中指定的所有不存在資料夾。舉例來說,如果名為
dir1/foo.txt的物件不存在,系統會自動建立dir1/資料夾。私密或個人識別資訊 (PII):資料夾名稱的曝光範圍比資料夾中繼資料更廣。舉例來說,資料夾名稱會顯示在網址中,以及列出值區中的資料夾或物件時。請勿在資料夾名稱中加入機密資訊或 PII。
與代管資料夾互動:在啟用階層式命名空間的 bucket 中,您可以搭配使用代管資料夾和資料夾,管理存取權控管。
後續步驟
歡迎試用
如果您未曾使用過 Google Cloud,歡迎建立帳戶,親自體驗實際使用 Cloud Storage 平台的成效。新客戶還能獲得價值 $300 美元的免費抵免額,用於執行、測試及部署工作負載。
免費試用 Cloud Storage