本頁面由 Cloud Translation API 翻譯而成。

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

本頁說明啟用階層式命名空間的 bucket 中的資料夾。

總覽

如果 bucket 啟用階層命名空間，資料夾就會以資源的形式存在。您可以在資料夾中整理物件，結構類似於檔案系統。Cloud Storage 提供資料夾管理 API，可執行建立、刪除、重新命名及列出資料夾等作業，以及擷取資料夾中繼資料。

資料夾的中繼資料包含資料夾的結構化資訊。如要詳細瞭解資料夾中繼資料，請參閱 Cloud Storage JSON API 參考說明文件中的 Folder 資源。

資料夾中繼資料的主要元件如下：

建立資料夾時，請注意下列事項：

物件和資料夾名稱：啟用階層式命名空間的 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。

如果您未曾使用過 Google Cloud，歡迎建立帳戶，親自體驗實際使用 Cloud Storage 的成效。新客戶可以獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。