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 定價方案，才能繼續存取預設值區和所有其他 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 的變更也會影響您搭配 Cloud Storage for Firebase (也可能是 Cloud Firestore) 使用 Terraform 的方式。

我們瞭解您需要花時間評估並變更 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 日起，「預設 Google Cloud 資源」的概念不適用於新佈建的預設 Cloud Storage 值區。在此日期「後」配置的預設值集名稱格式為 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)。