值區與物件命名規範

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

值區名稱要求

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

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

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

值區名稱注意事項

值區名稱位於單個 Cloud Storage 命名空間中。這表示:

  • 每個值區名稱都不得重複。
  • 所有人都能看到值區的名稱。

如果您在建立值區時使用了既有值區的名稱,則 Cloud Storage 會傳回錯誤訊息。不過,刪除值區後,您或其他使用者可以重新將其名稱用於新值區。

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

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

物件名稱要求

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

  • 物件名稱可包含按任何順序排列的有效 Unicode 字元,如果名稱採 UTF-8 編碼,則長度須為 1 到 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,物件只存在於值區中,名稱為 。

就像值區一樣,您不能直接重新命名現有物件。您可以複製一個物件,將複製的版本以所需名稱命名,然後刪除該物件的原始版本作為取代。如需逐步指南,包括有關自動處理重新命名過程的 gsutil 和 Google Cloud Platform Console 等工具的操作說明,請參閱重新命名物件一文。

後續步驟

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

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

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