為 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. 找出要設定上限的服務,設定每月預算金額,然後按一下「Configure」(設定)。

    • 支出上限預算僅適用於「單一」專案,以及該專案中的「單一」合格服務。

    • 支出上限預算的日期範圍為每月,從每個月的第一天開始。

請注意,您也可以使用 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 控制台解除強制執行的支出上限。

在強制執行後提高支出上限

如果支出上限已強制執行,而您想在當月剩餘時間內以更高的預算繼續使用服務 (例如將上限從 $10 美元提高到 $20 美元),則無法在上限處於「Enforced」(已強制執行) 狀態時編輯預算金額。您必須先解除上限,才能設定更高的限制。

如要恢復服務並提高支出上限,請按照下列步驟操作:

  1. 解除支出上限:在 Firebase 控制台或 Google Cloud 控制台中,找出已強制執行的服務,然後按一下「Lift」(解除)。

    移除強制執行後,支出上限會進入待處理狀態。

  2. 等待解除作業完成:稍候幾分鐘,然後重新整理頁面,直到支出上限狀態顯示「已解除」。

    服務就會恢復。視服務而定,這項作業最多可能需要一小時。

  3. 更新預算金額:輸入新的每月預算金額,提高支出上限。儲存變更。

提高上限時的重要注意事項:

  • 與當月總支出綁定:新的預算金額仍與當月累積總支出綁定,包括在強制執行上限前,因報表延遲而產生的任何超額費用。

  • 設定高於當月支出的預算:請確認新預算高於當月已支出金額 (包括超額費用)。否則上限會立即觸發,並再次暫停服務。

  • 剩餘預算計算方式:當月剩餘預算為新門檻金額減去目前總支出。例如:

    1. 您在 Cloud Functions for Firebase設定了 $10 美元的支出上限。

    2. 支出達到 $10 美元 (加上報表延遲期間的 $1 美元超額費用,總計 $11 美元)。系統會強制執行上限,並暫停函式。

    3. 您確認流量合法,因此解除上限,並等待狀態顯示為「Lifted」(已解除)。

    4. 您將支出上限更新為 $20 美元。儲存這項修改後,支出上限會重設回「已設定」狀態。

    5. 函式會繼續在新的 $20 美元上限下執行,當月預算約剩 $9 美元 ($20 美元上限減去已累積的 $11 美元)。

    6. 下個月,支出上限預算會維持 $20 美元的門檻。

支出上限預算的限制

以下是支出上限預算的重要限制:

  • 支出上限預算並非「硬性上限」。由於用量報表有延遲,支出上限不會立即生效,可能會延遲幾分鐘。這段期間產生的超額費用會照常計費。建議將預算設為略低於絕對上限。

  • 專案和服務範圍。支出上限預算的範圍僅限於單一專案,以及該專案中的單一合格服務。

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

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

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

  • 每月日期範圍。支出上限預算的日期範圍為每月,從每個月的第一天開始。

  • 服務每月會自動恢復。

    • 如果不解除已強制執行的支出上限,服務只會在這個月維持暫停。下個月初,已觸發的支出上限會自動重設為「Configured」(已設定) 狀態,並恢復原始預算和服務。

    • 如果您在當月解除已強制執行的支出上限,且「不」變更預算,服務在當月剩餘時間內會不設支出上限,支出上限會自動重設為「已設定」狀態,並採用原始預算,服務也會恢復。

  • 不含節省金額和抵免額。支出上限預算的費用計算方式是以總費用為準,不包含節省的金額和抵免額。

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