本页面介绍了当 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 强制执行了支出上限（并暂停了适用服务的所有新用量），但强制执行的支出上限已被明确解除，以恢复服务。
在已解除状态下，服务将在当月剩余时间内无支出限额运行，除非您重新配置或提高上限。在下个月开始时，原始支出上限预算会自动重新启用。
如果您不解除已强制执行的支出上限，此服务将仅在本月剩余时间内保持暂停状态。然后，在下个月初，强制执行的支出上限将自动重置，服务将恢复。
设置和管理支出上限
配置支出上限预算。
配置支出上限预算，以便 Cloud Billing 可以开始主动监控项目在特定服务上的支出。了解提醒和支出上限强制执行。
如果项目的支出达到该服务每月预算的特定阈值，Cloud Billing 会发送提醒电子邮件并强制执行支出上限。强制执行意味着在该月的剩余时间内，该服务的任何新用量都会暂停。（可选）提高已强制执行的支出上限（或增加其预算）。
如果您想在当月恢复使用已暂停的服务（不设限额或采用更高的预算），则需要明确解除已强制执行的支出上限。
所需权限
如需设置和管理支出上限预算，您需要对项目及其关联的 Cloud Billing 账号拥有管理员级访问权限。以下任一选项都会向您授予所需权限：
选项 1：与项目关联的 Cloud Billing 账号的 Billing Account Administrator 角色
选项 2：在要配置支出上限预算的项目中拥有 Project Owner 角色
方法 3：以下 Cloud Billing 账号和项目级 IAM 角色组合：
与项目关联的 Cloud Billing 账号的 Billing Account Costs Manager 角色
和
针对要在其中配置支出上限预算的项目的 Project Editor 角色
配置支出上限预算
如需让 Cloud Billing 主动开始监控某项服务的支出，您需要为该服务配置支出上限预算。如果您的项目达到该服务的特定支出阈值，Cloud Billing 将发送提醒邮件并强制执行支出上限。
下面介绍了如何使用 Firebase 控制台配置支出上限预算：
在 Firebase 控制台中访问您的项目，然后前往
设置 > 使用量和结算 > 详情和设置页面。前往服务级支出上限卡片。
找到要设置上限的服务，设置每月预算金额，然后点击配置。
支出上限预算的范围限定为单个项目以及该项目中的单个符合条件的服务。
支出上限预算的时间范围为每月，从每月的第一天开始。
请注意，您还可以使用 Google Cloud 控制台配置支出上限预算。
提醒电子邮件和支出上限强制执行
配置支出上限预算后，Cloud Billing 将主动监控项目在该服务上的支出。它将根据该服务的支出上限预算的以下支出阈值发送提醒电子邮件并强制执行支出上限。
50% 和 80%：
- Cloud Billing 向所有结算管理员、Project Owner 和任何适用的“重要联系人”发送警告提醒邮件。
100% 的设定预算：
Cloud Billing 强制执行支出上限，这意味着在当月剩余时间内，适用服务的任何新用量都将被暂停，除非您明确解除强制执行的支出上限。
Cloud Billing发送另一封提醒邮件。此外，Firebase 控制台和 Google Cloud 控制台会显示有关支出上限强制执行和暂停服务的横幅通知。
客户端影响和错误处理
当服务因强制执行支出上限而暂停时，您的客户端应用将开始针对该服务抛出错误。您应在应用代码中妥善处理这些异常（例如，使用 try-catch 块）。
解除已强制执行的支出上限
如果触发并强制执行支出上限，则适用服务的所有新使用都会在本月剩余时间内暂停，除非您明确解除强制执行的支出上限。
以下是使用 Firebase 控制台解除强制执行的支出上限的方法：
在 Firebase 控制台中访问您的项目，然后前往
设置 > 使用量和结算 > 详情和设置页面。前往服务级支出上限卡片。
找到已强制执行支出上限的服务，然后点击解除。
请注意，您还可以使用 Google Cloud 控制台解除强制执行的支出上限。
在支出上限生效后提高上限
如果您的支出上限已强制执行，而您希望在当月剩余时间内以更高的预算恢复服务（例如，将限额从 10 美元提高到 20 美元），则无法在上限处于强制执行状态时修改预算金额。您必须先解除上限，然后才能设置更高的限额。
如需恢复服务并提高其支出上限，请按以下步骤操作：
解除支出上限：在 Firebase 控制台或 Google Cloud 控制台中，找到已强制执行的服务，然后点击解除。
在移除强制执行期间，支出上限将进入待处理状态。
等待解除完成：等待几分钟，然后刷新页面，直到支出上限状态显示为已解除。
服务将会恢复。此过程最多可能需要 1 小时，具体取决于服务。
更新预算金额：通过输入新的、更高的每月预算金额来修改支出上限预算。保存更改。
提高上限时的重要注意事项：
与当月的总支出相关联：新的预算金额仍与当月的累计总支出相关联，包括在达到上限之前因报告延迟而产生的任何超额费用。
设置高于当月支出的预算：确保新预算高于您本月已支出的金额（包括超额支出）。否则，上限会立即触发并再次暂停服务。
剩余预算计算：您当月的剩余预算是新的限额金额减去您迄今为止的总支出。例如：
您为“Cloud Functions for Firebase”设置了 10 美元的支出上限。
您的支出达到 10 美元（加上报告延迟期间的 1 美元超额费用，总计 11 美元）。系统会强制执行上限，暂停您的函数。
您确认流量是合法的，因此您解除上限并等待状态显示为已解除。
您将支出上限更新为 20 美元。保存此修改后，支出上限会重置回已配置状态。
您的函数会继续在新的 20 美元上限下运行，当月剩余预算约为 9 美元（20 美元限额减去已产生的 11 美元）。
下个月，支出上限预算将保持 20 元的阈值。
支出上限预算的限制
以下是关于支出上限预算的重要限制：
支出上限预算不是“硬性上限”。由于用量报告存在延迟，支出上限强制执行并非即时生效，可能会延迟几分钟。在此延迟期间产生的任何超额费用都将正常计费。考虑将预算设置为略低于绝对上限。
项目和服务级。支出上限预算的范围限定为单个项目以及该项目中的单个符合条件的服务。
您无法在整个 Cloud Billing 账号级别或文件夹、组织或标签级别设置支出上限预算。
您无法设置涵盖多个项目或多项服务的单一支出上限预算。
为某项服务设置支出上限预算后，该预算将适用于您在项目中与该服务进行交互的所有方式。例如，如果您为 Agent Platform Gemini API (formerly Vertex AI) 设置了预算，则该预算也适用于在项目中通过 Firebase SQL Connect、ADK、Genkit 等方式对该 API 的任何使用（而不仅仅是通过 Firebase AI Logic 的使用）。
每月时间范围。支出上限预算的时间范围为每月，从每月的第一天开始。
服务每月会自动恢复。
如果您不解除已强制执行的支出上限，此服务将仅在本月剩余时间内保持暂停状态。在下个月初，强制执行的支出上限会自动重置为已配置状态，并恢复原始预算，服务也会恢复。
如果您在当月解除已强制执行的支出上限，并且不更改预算，则该服务在当月剩余时间内运行时将没有支出限额，并且支出上限会自动重置为已配置状态，并恢复原始预算，服务也会恢复。
不包括节省的费用和赠金。支出上限预算的费用计算基于总费用，不包括节省的费用和赠金。
如果您有更高级的结算设置，可以在 Google Cloud 文档中详细了解支出上限预算的限制。