为 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 控制台解除强制性支出上限。

在支出上限生效后提高支出上限

如果支出上限处于强制执行状态,而您想在当月剩余时间内以更高的预算恢复服务(例如,将限额从 10 美元提高到 20 美元),则无法在上限处于强制执行状态时修改预算金额。您必须先解除上限,然后才能设置更高的限额。

以下是恢复服务并提高其支出上限的方法:

  1. 提高支出上限:在 Firebase 控制台或 Google Cloud 控制台中,找到强制执行的服务,然后点击提高。

    在移除强制执行时,支出上限将进入待处理状态。

  2. 等待提升完成:等待几分钟,然后刷新页面,直到支出上限状态显示为已提升。

    服务将恢复。根据服务而定,此过程最多可能需要 1 小时。

  3. 更新预算金额:输入新的更高每月预算金额,以修改支出上限预算。保存更改。

提高限额时的重要注意事项:

  • 与当月的总支出相关联:新的预算金额仍与您当月累计的总支出相关联,包括在强制执行限额之前因报告延迟而产生的任何超额费用。

  • 设置高于当月支出的预算:请确保新预算高于您本月已支出的金额(包括超支金额)。否则,系统会触发支出上限,并立即再次暂停服务。

  • 剩余预算的计算方式:您当月的剩余预算为新阈值金额减去您迄今为止的总支出。例如:

    1. 您为“Cloud Functions for Firebase”设置了 10 美元的支出上限。

    2. 您的支出达到 10 美元(加上报告延迟期间的 1 美元超额费用,总计 11 美元)。系统会强制执行支出上限,并暂停您的函数。

    3. 您确认流量是正常的,因此解除上限,并等待状态显示为已解除。

    4. 您将支出上限更新为 20 美元。保存此修改后,支出上限会重置回已配置状态。

    5. 您的函数将继续在新的 20 美元上限下运行,本月剩余预算约为 9 美元(20 美元限额减去已累积的 11 美元)。

    6. 下个月,支出上限预算将保持 20 美元的阈值。

支出上限预算的限制

以下是有关支出上限预算的重要限制,请务必了解:

  • 支出上限预算不是“硬性上限”。由于使用情况报告存在延迟,支出上限的强制执行不是即时生效,可能会延迟几分钟。在此延迟期间产生的任何超额费用都将照常计费。请考虑将预算设置得略低于绝对限额。

  • 项目和服务范围。支出上限预算的范围限定为单个项目以及该项目中的单个符合条件的服务。

    • 您无法在整个 Cloud Billing 账号级层或文件夹、组织或标签级层设置支出上限预算。

    • 您无法设置一个支出上限预算来涵盖多个项目或多个服务。

    • 为服务设置支出上限预算后,该预算将适用于您在项目中与该服务进行互动的任何方式。例如,如果您为 Agent Platform Gemini API (formerly Vertex AI) 设置了预算,则该预算也适用于项目中通过 Firebase SQL Connect、ADK、Genkit 等(而不仅仅是通过 Firebase AI Logic)对该 API 的任何使用。

  • 月度时间范围。支出上限预算的时间范围为每月,从每个月的第一天开始。

  • 系统每月会自动恢复服务。

    • 如果您不解除强制执行的支出上限,此服务将仅在本月剩余时间内保持暂停状态。在下个月初,强制执行的支出上限会自动重置为已配置状态,并恢复为原始预算,服务也会恢复。

    • 如果您在当月解除强制执行的支出上限,但未更改预算,则该服务在当月剩余时间内将不受支出上限的限制,并且支出上限会自动重置为已配置状态,并恢复为原始预算,服务也会恢复。

  • 不包括节省的费用和积分。支出上限预算的费用计算基于总费用,不包括节省的费用和赠金。

如果您有更高级的结算设置,可以在 Google Cloud 文档中详细了解支出上限预算的限制。