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

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

本頁面提供啟用階層式命名空間的值區中資料夾的相關資訊。

總覽

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

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

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

建立資料夾時，請考量下列事項：

物件和資料夾名稱：已啟用階層命名空間的值區支援所有有效的物件名稱，包括開頭或結尾有斜線 (/) 或連續斜線的名稱。物件名稱中的每個正斜線 (/) 代表一個資料夾。下表列出物件名稱與其在資料夾階層中的對應位置之間的關係範例：

物件名稱	資料夾階層中的位置
`foo.txt`	每個資料夾都包含一個根目錄。物件 `foo.txt` 位於值區的根資料夾下。
`dir1/foo.txt`	物件 `foo.txt` 位於名為 `dir1/` 的頂層資料夾中。頂層資料夾與根資料夾不同。
`dir1/`	物件名稱中的尾隨斜線 (例如 `dir1/`) 表示物件位於資料夾中。在這個範例中，物件名稱 `dir1/` 與父資料夾名稱 `dir1/` 相同。
`dir1//foo.txt`	物件 `foo.txt` 位於名為 `dir1//` 的次級資料夾中，該資料夾是 `dir1/` 的子資料夾。

資料夾深度上限：已啟用階層命名空間的值區，資料夾深度上限為 50。因此，物件名稱中的斜線 (/) 不得超過 50 個。
資料夾名稱大小上限：512 個位元組 (UTF-8 編碼)。
自動建立資料夾：建立新物件時，系統會自動建立物件路徑中指定的任何不存在的資料夾。舉例來說，如果您建立名為 dir1/foo.txt 的物件，系統會自動建立資料夾 dir1/ (如果該資料夾尚不存在的話)。
機密資訊或個人識別資訊 (PII)：相較於資料夾中繼資料，相片名稱的公開程度更高。舉例來說，資料夾名稱會顯示在網址中，以及在列出值區中的資料夾或物件時。請勿在資料夾名稱中加入機密資訊或 PII。

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