為 Firebase 服務設定支出上限


本頁說明 Firebase 專案採用 Blaze 定價方案時，如何設定及管理支出上限預算。

下列特定 Firebase 服務可使用預算上限： Firebase AI Logic、Firebase App Hosting、Cloud Functions for Firebase 和 Firebase Extensions。

跳至設定支出上限的操作說明

瞭解預算

您可以為 Google Cloud Billing 建立預算，控管費用並避免產生意外的支出。預算是您計畫每月支出的金額，可分為僅限快訊的預算或支出上限預算。

僅限快訊的預算

  • 如果支出達到預算設定的門檻，Cloud Billing 就會傳送電子郵件通知。

  • 注意事項：

    • 預算快訊不會暫停服務。這些警示旨在協助您監控費用，並在必要時提醒您採取行動。舉例來說，您可以考慮使用預算通知停用專案的計費功能。

    • 在 Firebase 控制台中升級至 Blaze 定價方案時，系統會自動提示您設定僅限快訊的預算。您也可以在 Google Cloud 控制台中手動設定僅限快訊的預算。

支出上限預算 (本頁面)

  • 如果特定服務的支出達到預算設定的門檻，Cloud Billing 就會傳送電子郵件通知。

  • 如果支出達到該服務預算金額的 100%，Cloud Billing 服務會在該月剩餘時間暫停。

  • 注意事項：

    • 預算上限僅適用於下列 Firebase 服務： Firebase AI Logic、Firebase App Hosting、Cloud Functions for Firebase 和 Firebase Extensions。

    • 您可以在 Firebase 控制台 (如本頁所述) 或 Google Cloud 控制台中，手動設定支出上限預算。

支出上限預算總覽

設定支出上限預算前，請先詳閱本節資訊，包括適用服務清單和可能的支出上限狀態。此外，我們也建議您參閱本頁後續的支出上限預算限制。

您也可以在 Google Cloud 說明文件中，查看支出上限預算常見問題清單。

符合資格的服務

您可以為下列 Firebase 服務設定支出上限：

  • Firebase AI Logic：設定 Gemini Developer API 或 Agent Platform Gemini API (formerly Vertex AI) 的存取上限。
  • Firebase App Hosting：設定基礎 Cloud Run 服務的上限。
  • Cloud Functions for Firebase：為基礎 Cloud Run functions 服務設定上限。
  • Firebase Extensions：為基礎 Cloud Run functions 服務設定上限。

我們會持續擴充支出上限預算適用的服務清單，請定期查看。

支出上限狀態

支出上限可能處於下列其中一種狀態：

  • 已設定：Cloud Billing 會根據支出上限預算，主動監控專案在特定服務的支出。
  • 已強制執行：專案的支出已達到該服務設定的每月預算 100%，因此 Cloud Billing 強制執行支出上限。除非明確解除強制執行的支出上限，否則本月剩餘時間內，服務都會暫停，無法再使用。
  • 已解除：Cloud Billing 已強制執行支出上限 (並暫停適用服務的所有新用量)，但強制執行的支出上限已明確解除，服務也已恢復運作。

設定及管理支出上限

  1. 設定支出上限預算。
    設定支出上限預算，Cloud Billing 即可開始主動監控專案在特定服務的支出。

  2. 瞭解提醒和支出上限強制執行。
    如果專案的支出達到該服務每月預算的特定門檻，Cloud Billing 會傳送快訊電子郵件，並強制執行支出上限。強制執行是指該服務在本月剩餘期間會暫停，無法再使用。

  3. 視需要解除強制執行的支出上限。
    如要恢復當月暫停的服務，請明確解除強制執行的支出上限。

所需權限

如要設定及管理支出上限預算，您必須具備專案和連結 Cloud Billing 帳戶的管理員層級存取權。您可以透過下列任一方式取得必要權限：

設定支出上限預算

如要讓 Cloud Billing 主動開始監控服務支出，您必須為該服務設定支出上限預算。如果專案達到該服務的特定支出門檻，Cloud Billing 會傳送快訊電子郵件並強制執行支出上限。

以下說明如何使用 Firebase 控制台設定支出上限預算：

  1. 在 Firebase 控制台中存取專案，然後依序前往「 設定」>「 用量和帳單」>「 詳細資料和設定」頁面。

  2. 前往「服務等級支出上限」資訊卡。

  3. 找出要設定上限的服務，設定每月預算金額，然後按一下「設定」。

    • 支出上限預算的適用範圍為單一專案，以及該專案中單一符合條件的服務。

    • 支出上限預算的時間範圍為每月，從每個月的第一天開始。

請注意，您也可以使用 Google Cloud 控制台設定支出上限預算。

快訊電子郵件和支出上限強制執行

設定支出上限預算後，Cloud Billing 會主動監控專案在該服務的支出。系統會根據該服務支出上限預算的下列支出門檻，傳送快訊電子郵件並強制執行支出上限。

  • 已用完設定預算的 50% 和 80%：

    • Cloud Billing 傳送警告快訊電子郵件給所有帳單管理員、專案擁有者和任何適用的「必要聯絡人」。

  • 100% 的設定預算：

    • Cloud Billing 強制執行支出上限，也就是說，除非您明確解除強制執行的支出上限，否則在當月剩餘期間，適用服務的新用量都會暫停。

    • Cloud Billing 系統會傳送另一封快訊電子郵件。此外，Firebase 和 Google Cloud 控制台也會顯示橫幅通知，說明支出上限的強制執行和服務暫停情形。

用戶端影響和錯誤處理

如果服務因強制執行支出上限而暫停，用戶端應用程式就會開始擲回該服務的錯誤。您應在應用程式碼中妥善處理這些例外狀況 (例如使用 try-catch 區塊)。

暫停強制執行的支出上限

如果系統觸發並強制執行支出上限，適用服務的所有新用量都會在本月剩餘期間暫停，除非您明確解除強制執行的支出上限。

如要使用 Firebase 控制台解除強制執行的支出上限，請按照下列步驟操作：

  1. 在 Firebase 控制台中存取專案，然後依序前往「 設定」>「 用量和帳單」>「 詳細資料和設定」頁面。

  2. 前往「服務等級支出上限」資訊卡。

  3. 找出設有強制支出上限的服務，然後按一下「調高」。

請注意，您也可以使用 Google Cloud 控制台解除強制執行的支出上限。

支出上限預算的限制

以下是瞭解支出上限預算時的重要限制：

  • 支出上限預算「不是」「強制上限」。由於用量報表有延遲，因此系統不會立即強制執行支出上限，可能會延遲幾分鐘。延遲期間產生的任何超額費用，系統仍會照常計費。建議將預算設為略低於絕對上限。

  • 專案和服務範圍。支出上限預算適用於單一專案，以及該專案中單一符合條件的服務。

    • 您無法在整個 Cloud Billing 帳戶層級，或在資料夾、機構或標籤層級設定支出上限預算。

    • 您無法設定單一支出上限預算，涵蓋多個專案或多項服務。

    • 為服務設定支出上限預算後，該預算會套用至您在專案中與服務互動的任何方式。舉例來說，如果您在 Agent Platform Gemini API (formerly Vertex AI) 中設定預算，則透過 Firebase SQL Connect、ADK、Genkit 等在專案中使用該 API 時，也會套用該預算 (不只是透過 Firebase AI Logic 使用時)。

  • 每月時間範圍。支出上限預算的時段為每月，從每個月的第一天開始。

  • 服務預設為每月恢復。如果不解除強制執行的支出上限，服務只會在本月維持暫停。

    • 根據預設，系統會在下個月初自動解除已觸發的支出上限，並恢復服務。

    • 不過，您可以調整支出上限預算設定，無限期強制執行支出上限 (並暫停服務)，直到您明確解除強制執行的支出上限為止。

    根據預設，如果未解除已觸發的支出上限，服務會在當月維持暫停狀態，但會在下個月初自動恢復運作。不過，您可以調整支出上限預算設定，讓支出上限無限期維持強制執行狀態 (服務也會維持暫停狀態)，直到您明確解除強制執行的支出上限為止。

  • 不含節省金額和抵免額。支出上限預算的費用計算依據為總費用，不含節省金額和抵免額。

如果您有更進階的帳單設定，請參閱 Google Cloud 說明文件，進一步瞭解支出上限預算的限制。