2024 年 9 月公布的 Cloud Storage for Firebase 異動常見問題

Firebase 會對 Cloud Storage for Firebase 進行一些變更，並採取主動措施，防止平台上出現濫用行為。因此，我們必須更新基礎架構，以便更符合 Google Cloud Storage 配額和帳單。

這些基礎架構變更的其中一個結果是，我們很快就會開始要求專案採用以用即付的 Blaze 定價方案，才能使用 Cloud Storage for Firebase。即便採用 Blaze 定價方案，還是可以享有免付費用量。

請參閱下列常見問題，瞭解我們在 2024 年 9 月宣布的異動：

• 定價方案規定異動
• 預設 Cloud Storage for Firebase 值區的變更
• 程式輔助互動 (例如 REST API 和 Terraform) 的變更
• 「預設 Google Cloud 資源」的變更

定價方案規定異動

如要使用 Cloud Storage for Firebase，您很快就必須採用即付即用 Blaze 定價方案。即便採用 Blaze 定價方案，還是可以享有免付費用量。

重要事項：以下是本節常見問題的摘要重點 (但請務必詳閱下方的每個常見問題)：

• 自 2024 年 10 月 30 日起，您的 Firebase 專案必須採用即付即用 Blaze 定價方案，才能佈建新的 Cloud Storage for Firebase 預設 bucket。這個儲存空間可選擇使用 「一律免費」級別的 Google Cloud Storage。
• 自 2025 年 10 月 1 日起，您的 Firebase 專案必須採用即付即用 Blaze 定價方案，才能繼續存取預設 bucket 和所有其他 Cloud Storage 資源。任何 *.appspot.com 預設值區塊都會維持目前的免付費用量等級，即使採用 Blaze 定價方案也不例外。

我們瞭解您需要花時間評估並變更 Firebase 專案和工作流程。如有任何問題，請與 Firebase 支援團隊聯絡。

2024 年 9 月宣布的新價格方案規定為何？

• 自 2024 年 10 月 30 日起，將實施以下變更：

  • 如要使用 Firebase 主控台或 REST API 佈建新的預設值區，您的專案必須採用即付即用 Blaze 定價方案。

  • 請注意，2024 年 10 月 30 日之後提供的所有預設值區塊都會受到以下限制：

    • 這些資料夾會遵循 Google Cloud Storage 的價格和用量規定，該規定為 US-CENTRAL1、US-EAST1 和 US-WEST1 中的資料夾提供「一律免費」等級。

    • 名稱格式為 PROJECT_ID.firebasestorage.app (而非先前的 PROJECT_ID.appspot.com)。

• 自 2025 年 10 月 1 日起，將實施下列變更：

  • 如要繼續存取預設值區和所有其他 Cloud Storage 資源，專案必須採用即付即用 Blaze 定價方案。任何 *.appspot.com 預設值區塊都會維持目前的免付費用量等級，即使採用 Blaze 定價方案也一樣。

進一步瞭解如未在期限前升級至 Blaze 定價方案的後果。如有任何疑問，請與 Firebase 支援團隊聯絡。

為什麼 Firebase 要調整定價方案？

Firebase 致力於確保產品和生態系統的安全。為此，我們對 Cloud Storage for Firebase 進行了一些變更，並採取主動措施，防止平台上出現濫用行為。這包括更新基礎架構，以便更符合 Google Cloud Storage 配額和帳單。

如果我升級至 Blaze 定價方案，可以繼續享有免付費用量嗎？

可以，如果您有 PROJECT_ID.appspot.com 預設值區，並升級至即付即用 Blaze 定價方案，則會維持預設值區目前的免付費使用量，如下所述。超過免費使用量的部分，則會依據 Google App Engine 定價計費。

• 儲存的資料量 (5 GB)
• 每天下載 1 GB
• 20,000 次上傳 / 天
• 50,000 次下載 / 天

請注意，自 2024 年 10 月 30 日起，所有新的預設儲存桶名稱格式為 PROJECT_ID.firebasestorage.app，並遵循 Google Cloud Storage 的定價和用量，為 US-CENTRAL1、US-EAST1 和 US-WEST1 中的儲存桶提供「永遠免費」等級。

如何升級至 Blaze 定價方案？

如要將專案升級至即付即用 Blaze 定價方案，您必須將專案連結至 Cloud Billing 帳戶。您可以使用 Firebase 控制台工作流程升級定價方案。

如要升級定價方案，您必須具備專案的 擁有者 IAM 角色。

重要事項： 升級至 Blaze 定價方案後，強烈建議您設定預算快訊。升級價格方案的控制台流程會自動提示您設定這項快訊。進一步瞭解如何避免產生意外帳單。

如有任何問題，請與 Firebase 支援團隊聯絡。

我何時需要升級至 Blaze 定價方案？

如要繼續存取 PROJECT_ID.appspot.com 預設值區，請在 2025 年 10 月 1 日前升級至即付即用 Blaze 定價方案。

如要將專案升級至即付即用 Blaze 定價方案，您必須將專案連結至 Cloud Billing 帳戶。您可以使用 Firebase 控制台工作流程升級定價方案。

如果我沒有將專案升級至 Blaze 定價方案，會發生什麼事？

• 自 2024 年 10 月 30 日起：如果您尚未在專案中佈建預設 Cloud Storage 值區，則必須採用 Blaze 定價方案，才能佈建該值區。

• 自 2025 年 10 月 1 日起：如果您的專案未採用 Blaze 定價方案，就會失去對 PROJECT_ID.appspot.com 預設值區的讀/寫存取權。您也無法在 Firebase 控制台或 Google Cloud 控制台中查看或存取該桶。

  請注意，所有資料都會保留在 bucket 中，但您必須升級至 Blaze 定價方案，才能存取這些資料。

如有任何問題，請與 Firebase 支援團隊聯絡。

如果 *.appspot.com 預設儲存空間的用量超過免付費用量等級，會發生什麼情況？

如果您有 PROJECT_ID.appspot.com 預設值區，並且升級至 Blaze 定價方案，但用量超過下方所述的免費用量等級，系統會在下一個帳單週期根據 Google App Engine 定價 向您收取超出部分的費用。

• 儲存的資料量 (5 GB)
• 每天下載 1 GB
• 20,000 次上傳 / 天
• 50,000 次下載 / 天

如有任何問題，請與 Firebase 支援團隊聯絡。

預設 Cloud Storage 值區的變更

重要事項：以下是本節常見問題的摘要重點 (但請務必詳閱下方的每個常見問題)：

• 自 2024 年 10 月 30 日起，所有新佈建的預設 Cloud Storage bucket 名稱格式將為 PROJECT_ID.firebasestorage.app。
  這些值區會遵循 Google Cloud Storage 價格和用量，為 US-CENTRAL1、US-EAST1 和 US-WEST1 中的值區提供「一律免費」等級。
• 任何現有的 PROJECT_ID.appspot.com 預設分桶都不會有所變動 (只要您在 2025 年 10 月 1 日前將專案升級至即付即用 Blaze 定價方案)。

我們瞭解您需要花時間評估並變更 Firebase 專案和工作流程。如有任何問題，請與 Firebase 支援團隊聯絡。

預設值區的名稱會變更嗎？

否。升級至 Blaze 定價方案後，預設 Cloud Storage 值區的名稱「不會」變更。

• 如果您在 2024 年 10 月 30 日前佈建預設儲存桶，則預設儲存桶的名稱格式一律為 PROJECT_ID.appspot.com。

  唯一的例外狀況是您刪除 *.appspot.com 值區並佈建新的預設值區。

• 如果您在 2024 年 10 月 30 日當天或之後設定預設值區，則預設值區的名稱格式一律為 PROJECT_ID.firebasestorage.app。

刪除 *.appspot.com 預設資料夾後會有什麼影響？

已刪除的值區無法復原。請注意，這是所有 Cloud Storage 桶目前的行為。

自 2024 年 10 月 30 日起：如果您刪除 PROJECT_ID.appspot.com 預設值區，就無法佈建使用相同名稱格式的值區。

您可以改為建立新的預設 Cloud Storage 值區 (如果您的專案採用 Blaze 定價方案)，其名稱格式為 PROJECT_ID.firebasestorage.app。這項服務將遵循 Google Cloud Storage 的價格和用量規定，為 US-CENTRAL1、US-EAST1 和 US-WEST1 中的儲存桶提供「一律免費」等級。

我是否需要更新應用程式的程式碼集？

不需要。為了配合這些變更，您不需要更新應用程式的程式碼集。

所有現有的 PROJECT_ID.appspot.com 預設值區都會保留名稱格式。

為避免服務中斷，請務必在 2025 年 10 月 1 日前，將專案升級至即付即用 Blaze 定價方案。升級至 Blaze 定價方案後，您的程式碼集會繼續與 PROJECT_ID.appspot.com 預設值集區互動，就像以往一樣。

是否需要將資料從 *.appspot.com 預設儲存空間移出？

否。為因應這些異動，您不必將資料從 PROJECT_ID.appspot.com 預設儲存桶移出。

只要您在 2025 年 10 月 1 日前將專案升級至即付即用 Blaze 定價方案，就不會受到服務中斷影響。

程式輔助互動 (例如 REST API 和 Terraform) 的變更

如果您以程式輔助方式 (例如使用 REST API 或 Terraform) 配置或使用預設 Cloud Storage for Firebase 儲存體，請查看下列變更，瞭解是否需要變更工作流程或應用程式中的任何內容。

重要事項：以下是本節常見問題的摘要重點 (但請務必詳閱下方的每個常見問題)：

• 2024 年 10 月 30 日，我們將停用兩個 REST API：projects.defaultLocation.finalize 端點和 projects.availableLocations.list 端點。
• 這些 REST API 的變更也會影響您使用 Terraform 搭配 Cloud Storage for Firebase (可能還有 Cloud Firestore) 的方式。

我們瞭解您需要花時間評估並變更 Firebase 專案和工作流程。如有任何問題，請與 Firebase 支援團隊聯絡。

使用 REST API 時有哪些異動？

2024 年 10 月 30 日起，將實施下列異動：

• projects.defaultBucket.create 端點會變更：

  • 如要呼叫這個端點，您的專案必須採用即付即用 Blaze 定價方案。

  • 這個端點提供的預設值區名稱格式為 PROJECT_ID.firebasestorage.app (而非先前的 PROJECT_ID.appspot.com)。

  • 這些預設值區會遵循 Google Cloud Storage 的價格和用量，為 US-CENTRAL1、US-EAST1 和 US-WEST1 中的值區提供「Always Free」等級。

• projects.defaultLocation.finalize 和 projects.availableLocations.list 端點將關閉，並開始傳回 404: METHOD_NOT_FOUND 錯誤。

  如要以程式輔助方式設定資源位置，請改用資源專屬 API。舉例來說，請分別在呼叫 projects.defaultBucket.create 和 projects.databases.create 時，分別設定預設 Cloud Storage 值區和預設 Cloud Firestore 例項的位置。如要進一步瞭解如何替換 REST API 和位置，請參閱常見問題：如何設定或取得「預設 Google Cloud 資源」的位置？

使用 Terraform 有哪些變更？

2024 年 10 月 30 日起，以下與使用 Terraform 搭配 Cloud Storage for Firebase 相關的變更將生效。

您無法再使用 Terraform 佈建預設 Cloud Storage for Firebase 值區。這是因為您無法再透過 Google App Engine 配置這個值區。建議改用下列任一方法：

• 呼叫 projects.defaultBucket.create 來佈建值區。這個 API 尚未透過 Terraform 提供。

• 透過 Firebase 主控台佈建值區。如要開始使用，請前往控制台的「儲存空間」部分。

此外，請注意下列關於自 2024 年 10 月 30 日起佈建的預設 Cloud Storage 值區的事項：

• 您必須將專案升級至即付即用 Blaze 定價方案，才能佈建預設的 Cloud Storage 值區。

• 您不再需要在預設 Cloud Storage 值區之前，先佈建預設 Cloud Firestore 執行個體。

• 您為預設 Cloud Firestore 例項選取的位置不適用於預設 Cloud Storage 值區 (也就是說，預設 Cloud Firestore 例項和預設 Cloud Storage 值區可以位於不同位置)。

• 預設 Cloud Storage 值區的名稱格式為 PROJECT_ID.firebasestorage.app (而非先前的 PROJECT_ID.appspot.com)。

「預設 Google Cloud 資源」的變更

「預設 Google Cloud 資源」是指任何與 Google App Engine 相關聯的專案資源，包括以下項目：

• 預設 Cloud Firestore 執行個體
• 預設 Cloud Storage for Firebase 值區 (特別是名稱格式為 PROJECT_ID.appspot.com 的值區)
• Google Cloud Scheduler (專門用於第 1 代排程函式)

Firebase 生態系統多年以來經歷許多變化，因此 Firebase 相關資源與 Google App Engine 的關聯也隨之改變。

我們瞭解您需要花時間評估並變更 Firebase 專案和工作流程。如有任何問題，請與 Firebase 支援團隊聯絡。

「預設 Google Cloud 資源的位置」有什麼變化？

「預設 Google Cloud 資源的位置」是與 Google App Engine 相關聯的任何專案資源的位置設定，包括：

• 預設 Cloud Firestore 執行個體
• 預設 Cloud Storage for Firebase 值區 (特別是名稱格式為 PROJECT_ID.appspot.com 的值區)
• Google Cloud Scheduler (專門用於第 1 代排程函式)

在專案中設定任何一項資源時，您會間接設定專案中 Google App Engine 應用程式的所在位置。這會反過來為與 Google App Engine 相關聯的所有資源設定位置。

重要事項： 自 2024 年 10 月 30 日起，佈建預設 Cloud Storage 值區時，系統不會設定「預設 Google Cloud 資源的位置」(例如專案預設 Cloud Firestore 例項的位置)。此外，預設 Cloud Firestore 例項的佈建作業將不再設定新預設 Cloud Storage 值區的位置 (名稱格式為 PROJECT_ID.firebasestorage.app)。

注意事項：

• 在 2024 年 10 月 30 日之前預留的預設 Cloud Storage值區 (名稱格式為 PROJECT_ID.appspot.com) 會與 Google App Engine 建立關聯。這表示：

  • 值區的位置會設定與 Google App Engine 相關聯的資源位置 (例如預設 Cloud Firestore 執行個體的位置)。

• 自 2024 年 10 月 30 日起佈建的任何預設 Cloud Storage 值區 (名稱格式為 PROJECT_ID.firebasestorage.app) 不會與 Google App Engine 建立關聯。這表示：

  • 預設 Cloud Storage 值區的佈建作業將不再設定與 Google App Engine 相關聯的資源位置 (例如預設 Cloud Firestore 執行個體的位置)。

  • 預設 Cloud Firestore 執行個體的佈建作業將不再設定專案預設 Cloud Storage 值區的位置。

  • 預設 Cloud Storage 值區可用的地區，現在與Google Cloud Storage 可用的地區相同 (而非僅限於 Google App Engine 的地區)。

如何設定或取得「預設 Google Cloud 資源」的位置？

「預設 Google Cloud 資源」是指任何與 Google App Engine 相關聯的專案資源，包括以下項目：

• 預設 Cloud Firestore 執行個體
• 預設 Cloud Storage for Firebase 值區 (特別是名稱格式為 PROJECT_ID.appspot.com 的值區)
• Google Cloud Scheduler (專門用於第 1 代排程函式)

自 2024 年 10 月 30 日起，新佈建的預設 Cloud Storage bucket 不適用「預設 Google Cloud 資源」的概念。在此日期「後」配置的預設值集名稱格式為 PROJECT_ID.firebasestorage.app，且不會與 Google App Engine 建立關聯。如需更多資訊，請參閱常見問題：「預設 Google Cloud 資源的位置」會發生什麼事？

重要事項： 自 2024 年 10 月 30 日起佈建的預設 Cloud Storage bucket 不會與 Google App Engine 建立關聯，因此其位置資訊「不會」設定「預設 Google Cloud 資源的位置資訊」(例如預設 Cloud Firestore 執行個體的位置資訊)。此外，如果您在專案中先佈建預設 Cloud Firestore 執行個體，就不會再為這些新的預設 Cloud Storage 值區設定位置。

如果您想設定或取得專案中任何資源的位置，請改為直接與該資源互動。

預設 Cloud Storage for Firebase 值區

• 在 Firebase 控制台中：

  • 在 Firebase 控制台的「儲存空間」部分設定並找出預設 Cloud Storage 值區的位置。

• 使用 REST API：

  • 在呼叫 projects.defaultBucket.create 時，設定預設 Cloud Storage 儲存桶的所在位置。

    請注意，自 2024 年 10 月 30 日起，您必須採用即付即用 Blaze 定價方案，才能呼叫這個端點。因此，在嘗試建立預設值區之前，請確認專案已連結至 Cloud Billing 帳戶 (例如使用 projects.updateBillingInfo)。

  • 使用 projects.buckets.get 取得預設 Cloud Storage 值區的位置。

預設 Cloud Firestore 執行個體

請注意，如果您在 2024 年 10 月 30 日之前已佈建預設 Cloud Storage 儲存桶，則系統會將專案的預設 Cloud Firestore 執行個體位置設為預設 (因為與 Google App Engine 建立關聯)。

• 在 Firebase 控制台中：

  • 在 Firebase 主控台的 Firestore 專區中設定及查看預設 Cloud Firestore 例項的位置。

• 使用 REST API：

  • 在呼叫 projects.databases.create 時，設定預設 Cloud Firestore 例項的所在位置。

  • 使用 projects.databases.get 取得預設 Cloud Firestore 例項的位置。

排程函式 (第 1 代)

請注意，如果您在 2024 年 10 月 30 日之前已佈建預設 Cloud Storage 儲存桶，則專案的排程函式 (第 1 代) 已設定好 (因為與 Google App Engine 建立關聯)。

• 在設定和部署期間，設定排程函式的位置。

• 在 Google Cloud 主控台中，從工作和函式的主題名稱取得排定函式的位置 (firebase-schedule-FUNCTION_NAME-REGION)。