關於 Cloud Storage bucket

本頁面說明 Cloud Storage 中的資源「值區」。如要大致瞭解 Cloud Storage 的運作方式,請參閱 Cloud Storage 產品總覽

值區

值區是保存資料的基本容器。儲存在 Cloud Storage 的所有資料都必須放在值區中。您可使用值區來整理資料、控制資料的存取權,但值區不像目錄和資料夾可以層層套疊。

  • 定價 (例如資料儲存、資料處理和網路輸出資料傳輸的費用) 取決於多項因素,例如值區位置和其中的物件儲存空間類別。詳情請參閱 Cloud Storage 定價

在 bucket 中啟用階層式命名空間

建立值區時,您可以選擇為值區啟用階層結構式命名空間。啟用階層命名空間的 bucket 具有類似檔案系統的儲存結構,可將物件整理到資料夾階層中。這項功能可提升效能、一致性及管理便利性,特別適合資料密集型和檔案導向的工作負載。如要瞭解如何啟用階層式命名空間,請參閱「建立已啟用階層式命名空間的值區」。

值區名稱

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

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

值區名稱注意事項

  • 值區名稱位於單一命名空間,所有 Cloud Storage 使用者都會共用這個命名空間。也就是說:

    • 每個值區名稱都不得重複。

      如果您嘗試使用現有 bucket 的名稱建立 bucket,例如 example-bucket,Cloud Storage 會傳回錯誤訊息。

    • 所有人都能看到值區的名稱。

      請勿將使用者 ID、電子郵件地址、專案名稱、專案編號或任何個人識別資訊 (PII) 包含在值區名稱,因為這樣任何人都可以探測出值區的存在。

  • 刪除值區後,任何人都能在新值區重複使用其名稱。

    刪除值區後,名稱通常會在幾秒內重新開放使用,但請注意下列事項:

    • 如果您刪除包含該值區的專案 (這也會一併刪除值區),值區名稱可能要過幾週或更久才會釋出。
    • 如果在不同位置建立名稱相同的新值區,且時間在舊值區刪除後的 10 分鐘內,這段期間對新值區提出的要求可能會失敗,並顯示 404-Bucket Not Found 錯誤。
    • 如果您的要求是透過 XML API 傳送,在舊值區刪除後 10 分鐘內,嘗試在新位置建立重複名稱的值區可能會失敗,並顯示 404-Bucket Not Found 錯誤。
  • 您可以在 DNS 記錄中使用值區名稱,做為 CNAMEA 重新導向的一部分。

    如要這麼做,值區名稱應符合標準 DNS 命名慣例。也就是說,值區名稱不得使用底線 (_),也不得在半形句號或破折號的前後使用半形句號。舉例來說,..-..- 是 DNS 名稱中的無效字元組合。

值區名稱範例

以下是有效值區名稱的範例:

  • my-travel-maps
  • 0f75d593-8e7b-4418-a5ba-cb2970f0b91e
  • test.example.com (需要驗證 example.com 的擁有權)

以下是無效的 bucket 名稱範例:

  • My-Travel-Maps (包含大寫字母)
  • my_google_bucket (包含「google」)
  • test bucket (包含空格)

後續步驟