值區與物件命名規範

本頁說明在 Cloud Storage 中建立值區和上傳物件時應遵循的命名規範。要瞭解如何建立值區,請參閱建立儲存空間值區指南

值區名稱要求

值區名稱必須符合下列條件:

  • 值區名稱只能含有小寫字母、數字、連字號 (-)、底線 (_) 與點 (.)。如果名稱含有點,則必須經過驗證
  • 值區名稱的開頭與結尾都必須使用數字或字母。
  • 值區名稱必須包含 3 至 63 個字元。如果名稱中包含點,則其長度上限為 222 個字元,但每個以點分隔的字串組合不得超過 63 個字元。
  • 值區名稱不得為採用小數點十進位表示法 (例如 192.168.5.4) 的 IP 位址。
  • 值區名稱不得使用「goog」前置字串做為開頭。
  • 值區名稱不得包含「google」或類似錯別字,例如「g00gle」。

此外,為了符合 DNS 規範和日後的相容性,不可在英文句號或連字號的前後使用底線 (_) 或英文句號。例如,「..」、「-.」或「.-」在 DNS 名稱中為無效名稱。

值區名稱注意事項

值區名稱均儲存於單一 Cloud Storage 命名空間,這表示每個值區名稱均不得重複。如果您嘗試使用已指派給現有值區的名稱建立新值區,則 Cloud Storage 會顯示錯誤訊息。但刪除值區後,您或其他使用者就可以在建立新值區時重複使用其名稱。

值區名稱只能在建立程序中指派,您不能變更現有值區的名稱,而應使用需要的名稱建立新值區,並將舊值區中的內容移至新值區。如需逐步操作指南,請參閱移動及重新命名值區一文。

另請參閱命名最佳做法一節,其中提供在值區和物件名稱中排除使用專屬資訊的建議。

物件名稱要求

物件名稱必須符合下列條件:

  • 物件名稱可包含按任何順序排列的有效 Unicode 字元,如果名稱採 UTF-8 編碼,則長度不得超過 1024 個位元組。
  • 物件名稱不能含有回車或換行字元。
  • 物件名稱不能以 .well-known/acme-challenge 開頭。
  • 物件不能命名為 ...

如要進一步瞭解回車和換行字元,請參閱換行說明。

強烈建議您避免在物件名稱中使用下列項目:

  • 避免使用 XML 1.0 中無效的控制字元 (#x7F–#x84 及 #x86–#x9F):這些字元會在您嘗試列出物件時造成 XML 列表問題。
  • 避免在物件名稱中使用「#」:gsutil 會將結尾為 #<numeric string> 的物件名稱解譯為版本 ID,所以在物件名稱中納入「#」,會在使用 gsutil 時造成系統很難甚或無法對這類已建立版本的物件執行作業 (請參閱物件版本管理和並行控制一文)。
  • 避免在物件名稱中使用「[」、「]」、「*」或「?」:gsutil 會將這些字元解譯為萬用字元,所以在物件名稱中使用這些字元,會造成系統很難甚或無法使用 gsutil 執行萬用字元作業

物件名稱注意事項

物件名稱儲存於值區中的扁平命名空間,這表示不同值區可以有同名的物件,也表示物件不會儲存在值區中的子目錄。例如,您可以將物件命名為 /europe/france/paris.jpg,使它「看起來像是」/europe/france 子目錄中的 paris.jpg,但在 Cloud Storage 中,物件只是存在於值區中且名稱為 /europe/france/paris.jpg

就像值區一樣,您不能重新命名現有物件。但如果複製物件,將需要的名稱指派給新物件,然後刪除舊物件,則可有效達成重新命名。您可以使用 gsutil mv 指令輕鬆完成此程序,因為這項指令可自動處理此程序。對檔案而言 (但非資料夾),重新命名的另一個輕鬆實行方式是使用 Google Cloud Platform 主控台,按一下所需檔案的下拉式選單 (在檔案列的最右側垂直顯示的三個點),並點選 [move/rename] (移動/重新命名)。透過 JSON 和 XML API 使用 Google Cloud Storage 時,物件重新命名的明確執行方式為複製物件,然後刪除。

後續步驟

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Cloud Storage
需要協助嗎?請前往我們的支援網頁