TerraformでGoogle Cloudの予算アラートを作り、Pub/Sub通知の中身まで確かめた

Sat, 05 Sep 2026 00:00:05 +0900

概要
#

Cloud Billingの予算は、コスト管理の入口としてよく紹介されます。ところが設定しようとすると、いくつも引っかかります。

APIが無効で一覧すら取れません。terraform applyは403で通りません。Pub/Sub通知のために権限を付けろと書かれているサービスアカウントは、そもそも名前が違っていました。

そして最も大事な点があります。この記事で作る通知だけの予算（alerts-only budget）は、課金を止めません。

2026年7月27日に Spend Cap Budget が Preview で提供開始されました。対象サービスなら、新規の利用を自動停止できます。

対象サービスは4つです。

Gemini API
Gemini Enterprise Agent Platform
Cloud Run
Cloud Run functions

ただし、確かめた範囲では Terraform から作れませんでした。理由はあとで実際に確かめます。

上限に達しても通知が飛ぶだけで、リソースは動き続けます。「予算を設定したから安心」にはなりません。

元にしたPoCは通知を請求アカウントの既定メールに任せていて、届くかどうかを確かめていませんでした。この記事ではPub/Subに送り、メッセージを実際に読みます。

対象読者は、TerraformでGoogle Cloudのリソースを作ったことがある人です。請求周りの入門は扱いません。

通知を受けてリソースを停止する実装、組織レベルの予算、BigQueryへの課金データエクスポートは扱いません。

検証すること
#

User ADC から Budget API を使うのに何が要るのか
プロジェクトの指定は ID か番号か
Pub/Sub 通知は本当に届くのか
通知のメッセージには何が入るのか
Publisher の権限は誰が付けるのか
通常の予算を超えたら何が起きるのか
Spend Cap Budget は Terraform で作れるのか
予算の操作は監査ログで追えるのか

前提環境
#

Google Cloud CLI、Terraform
請求アカウントに対するroles/billing.adminまたはroles/billing.costsManager
通知先トピックのpubsub.topics.setIamPolicy（Budget API が Publisher ロールを付けるのに要る）。ドメイン制限共有を有効にしている組織では、あわせて除外設定も要る
Pub/Sub のトピックとサブスクリプションを作成・削除・受信する権限
User ADC を使う場合、billing_project に指定するプロジェクトのserviceusage.services.use
billing_project に指定するプロジェクトで Budget API（billingbudgets.googleapis.com）を有効化しておくこと
検証時のバージョン：Terraform 1.14.5、google 7.46.0

今回は請求アカウントの権限で作成します。プロジェクト1つを対象にする予算なら、プロジェクト側の権限でも作成できます（resourcemanager.projects.get / billing.resourcebudgets.read / billing.resourcebudgets.write）。

CloudBilling on LIFELOG

TerraformでGoogle Cloudの予算アラートを作り、Pub/Sub通知の中身まで確かめた

概要 #

検証すること #

前提環境 #

概要
#

検証すること
#

前提環境
#