このページでは、Firebase プロジェクトが Blaze のお支払いプランの場合に、費用上限予算を設定して管理する方法について説明します。
上限額予算は、Firebase AI Logic、Firebase App Hosting、Cloud Functions for Firebase、Firebase Extensions などの一部の Firebase サービスで利用できます。
予算について
Google Cloud Billing の予算を作成することで、費用を管理し、想定外の請求が発生する事態を回避できます。予算とは、1 か月あたりに使用する予定の金額です。アラートのみの予算または費用上限予算のいずれかになります。
アラートのみの予算
費用が予算に設定されたしきい値に達すると、Cloud Billing メール通知が送信されます。
次の点にご注意ください。
予算アラートによってサービスが一時停止されることはありません。予算と予算アラートは、費用をモニタリングし、必要に応じて対処できるようにアラートを送信することを目的としています。たとえば、予算通知を使用してプロジェクトの課金を無効にすることを検討します。
Firebase コンソールで Blaze のお支払いプランにアップグレードすると、アラート専用の予算を設定するよう自動的に求められます。Google Cloud コンソールでアラート専用の予算を手動で設定することもできます。
利用額上限の予算（このページ）
特定のサービスの予算の費用が設定されたしきい値に達すると、Cloud Billing がメール通知を送信します。
そのサービスの予算の 100% に達すると、Cloud Billing その月の残りの期間、そのサービスは一時停止されます。
次の点にご注意ください。
予算上限は、Firebase AI Logic、Firebase App Hosting、Cloud Functions for Firebase、Firebase Extensions の Firebase サービスでのみ使用できます。
費用上限予算は、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 サービスの上限を設定します。
Google は、費用上限予算の対象となるサービスのリストを拡充するよう取り組んでいます。このリストは定期的にご確認ください。
利用額上限の状態
費用上限は次のいずれかの状態になります。
構成済み: Cloud Billing は、利用額上限予算に基づいて、特定のサービスに対するプロジェクトの費用を積極的にモニタリングしています。
適用済み: プロジェクトの費用が、そのサービスに設定した月間予算の 100% に達したため、Cloud Billing が利用額上限を適用しました。適用された利用額上限が明示的に解除されない限り、今月の残りの期間、サービスの新規利用は一時停止されます。
解除済み: Cloud Billing が利用額上限を適用し（該当するサービスの新しい使用を一時停止）、適用された利用額上限が明示的に解除されてサービスが再開されました。
引き上げ状態では、上限を再構成または引き上げない限り、その月の残りの期間は利用額上限なしでサービスが実行されます。翌月の初めに、元の利用額上限予算が自動的に再度有効になります。
利用額上限を引き上げない場合、サービスは今月のみ一時停止されたままになります。翌月の初めには、適用された利用額上限が自動的にリセットされ、サービスが再開されます。
費用の上限を設定、管理する
利用額上限予算を構成します。Cloud Billing が特定のサービスに対するプロジェクトの支出を積極的にモニタリングできるように、利用額上限予算を構成します。
アラートと費用上限の適用について理解する。
プロジェクトの費用が、そのサービスの月額予算の特定のしきい値に達すると、Cloud Billing はアラート メールを送信し、利用額上限を適用します。適用とは、そのサービスの新規利用がその月の残りの期間、一時停止されることを意味します。必要に応じて、適用されている利用額上限を引き上げる（または予算を増やす）ことができます。
その月に一時停止されたサービスの使用を再開する場合（上限なし、またはより高い予算で）、適用された利用額上限を明示的に引き上げる必要があります。
必要な権限
費用上限予算を設定して管理するには、プロジェクトとそのリンクされた Cloud Billing アカウントに対する管理者レベルのアクセス権が必要です。次のいずれかのオプションで、必要な権限が付与されます。
オプション 1: プロジェクトにリンクされている Cloud Billing アカウントに対する請求先アカウント管理者ロール
オプション 2: 費用上限予算を構成するプロジェクトの プロジェクト オーナーロール
オプション 3: Cloud Billing アカウントとプロジェクト レベルの IAM ロールの次の組み合わせ:
プロジェクトにリンクされている Cloud Billing アカウントに対する請求先アカウントの費用管理者ロール
と
費用の上限予算を構成するプロジェクトに対する プロジェクト編集者ロール
費用の上限予算を構成する
Cloud Billing がサービスの費用のモニタリングをアクティブに開始するには、そのサービスの利用額上限予算を構成する必要があります。プロジェクトがそのサービスの特定の費用のしきい値に達すると、Cloud Billing はアラートメールを送信し、利用額上限を適用します。
Firebase コンソールを使用して費用上限予算を構成する方法は次のとおりです。
Firebase コンソールでプロジェクトにアクセスし、[
設定 ] > [使用量と請求額] > [詳細と設定] ページに移動します。[サービスレベルの利用額上限] カードに移動します。
上限を設定するサービスを見つけて、1 か月の予算額を設定し、[構成] をクリックします。
利用額上限予算は、1 つのプロジェクトと、そのプロジェクト内の1 つの対象サービスに適用されます。
費用上限予算の期間は月単位で、毎月 1 日から始まります。
Google Cloud コンソールを使用して費用上限予算を構成することもできます。
アラートメールと利用額上限の適用
利用額上限予算を構成すると、Cloud Billing はそのサービスのプロジェクトの支出を積極的にモニタリングします。このサービスの上限額予算の次の費用しきい値に基づいて、アラートメールを送信し、上限額を適用します。
設定した予算の 50% と 80%:
- Cloud Billing 警告アラート メールを送信して、すべての課金管理者、プロジェクト オーナー、該当する「重要な連絡先」に通知します。
設定した予算の 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 になります）。上限が適用され、関数が一時停止されます。
トラフィックが正当であることを確認したら、上限を引き上げ、状態が Lifted になるまで待ちます。
利用額上限を $20 に更新します。この変更を保存すると、費用上限は 構成済みの状態にリセットされます。
関数は新しい上限の 20 ドルで引き続き実行され、その月の予算は約 9 ドル（上限の 20 ドルからすでに発生した 11 ドルを差し引いた金額）になります。
翌月も、利用額上限の予算は 2, 000 円のしきい値が維持されます。
支出上限予算の制限事項
費用上限予算について理解しておくべき重要な制限事項は次のとおりです。
利用額上限の予算は「上限」ではありません。使用状況レポートのレイテンシにより、費用上限の適用は瞬時には行われず、数分遅れることがあります。この遅延中に発生した費用の超過分は、通常どおり請求されます。予算を絶対的な上限より少し低く設定することをおすすめします。
プロジェクトとサービスがスコープ設定されている。利用額上限の予算は、1 つのプロジェクトと、そのプロジェクト内の1 つの対象サービスに適用されます。
Cloud Billing アカウント全体、フォルダ、組織、ラベルのレベルで費用上限予算を設定することはできません。
複数のプロジェクトまたは複数のサービスを対象とする単一の費用上限予算を設定することはできません。
サービスの利用額上限予算を設定すると、プロジェクトでサービスを操作するすべての方法に適用されます。たとえば、Agent Platform Gemini API (formerly Vertex AI) に予算を設定すると、Firebase SQL Connect、ADK、Genkit などを介したプロジェクトでの API の使用量にも適用されます（Firebase AI Logic を介した使用量だけではありません）。
月間の期間。費用上限予算の期間は月単位で、毎月 1 日から始まります。
サービスは毎月自動的に再開されます。
利用額上限を<0x0A>引き上げない場合、サービスは今月のみ一時停止されたままになります。翌月の初めに、適用された利用額上限は元の予算で 構成済み状態に自動的にリセットされ、サービスが再開されます。
その月の途中で利用額上限を引き上げ、予算を変更しない場合、その月の残りの期間は利用額上限なしでサービスが実行され、利用額上限は元の予算で構成済みの状態に自動的にリセットされ、サービスが再開されます。
割引とクレジットは含まれません。利用額上限の予算の費用計算は総費用に基づいており、割引やクレジットは含まれません。
より高度なお支払い情報の設定を行っている場合は、Google Cloud ドキュメントの費用上限予算の制限事項をご覧ください。