關於啟用階層命名空間的值區中資料夾

本頁面提供已啟用階層式命名空間的 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