为 Firebase 服务设置支出上限


本页面介绍了当您的 Firebase 项目采用 Blaze 定价方案时,如何设置和管理 支出上限预算

支出上限预算适用于以下精选 Firebase 服务: Firebase AI LogicFirebase App HostingCloud Functions for FirebaseFirebase Extensions

跳转到配置支出上限的说明

了解预算

您可以创建预算 ,以控制费用并避免账单出现意外情况Google Cloud Billing预算 是指您每月计划支出的常规金额,可以是 仅提醒预算 ,也可以是 支出上限预算

仅提醒预算

  • 如果支出达到您预算的设定阈值, 则 Cloud Billing 发送电子邮件通知

  • 请注意以下几点:

    • 预算提醒 不会 暂停服务。它们旨在帮助您监控费用并提醒您,以便您在需要时采取行动。例如,您可以考虑 使用预算通知来停用项目的结算功能

    • Firebase控制台中升级到 Blaze 定价方案时,系统会自动提示您设置 仅提醒预算。 您还可以在 控制台中手动 Google Cloud设置仅提醒预算。

支出上限预算 (本页面)

  • 如果支出达到您预算的设定阈值 (针对特定服务), 则 Cloud Billing 会发送电子邮件通知

  • 如果支出达到该服务预算的 100%, 则 Cloud Billing 暂停该服务,直到本月结束

  • 请注意以下几点:

    • 支出上限预算仅适用于以下 Firebase 服务: Firebase AI LogicFirebase App HostingCloud Functions for FirebaseFirebase Extensions

    • 您可以在 Firebase控制台(如本页面所述)或 Google Cloud控制台中手动设置支出上限预算。

支出上限预算概览

在设置支出上限预算之前,请查看本部分中的信息, 其中包括符合条件的服务列表和 可能的支出上限状态。 我们还建议您查看本页面稍后介绍的 支出上限预算的限制。

您还可以在 文档 中找到有关支出上限预算的常见问题解答列表。Google Cloud

符合条件的服务

您可以为以下 Firebase 服务设置支出上限预算:

  • Firebase AI Logic:设置对 Gemini Developer APIAgent 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文档中找到更多详细信息。