为 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 文档中详细了解支出上限预算的限制。