Kanji
・クラウドエンジニア / フリーランス ・1993年生まれ ・愛媛県出身 / 東京都渋谷区在住 ・AWS歴5年 プロフィールの詳細
目次
社内システムのクラウド移行やインフラ構築を進める中で、僕がいつも胃を痛めていたのが「事前コスト試算の手間と、月末の請求書を見る瞬間の恐怖」でした。
開発者が気軽に Terraform や AWS CDK でリソースを立ち上げたり、最近では自律AIエージェント(Antigravity や Claude Code 等)にプロンプトで「検証用のステージング環境を組んでおいて」と指示すると、ほんの数分で VPC、NAT Gateway、EKS クラスタ、検証用 RDS、踏み台 EC2 が綺麗にプロビジョニングされます。
しかし、そこに潜む落とし穴が「意図しない過剰スペックや高額リソースの立ち上がり」です。 以前、ある検証プロジェクトで開発者が NAT Gateway をマルチAZで冗長配置し、検証用コンテナのイメージプルや巨大ログ転送を繰り返した結果、わずか1週間で数万円のデータ転送費用が膨らみ、月末の請求アラートで慌てて削除するという苦い経験がありました。
このような事故を防ぐため、プルリクエスト(PR)の段階で「このインフラ変更で月額いくら増えるのか」を自動計算し、予算超過があれば CI をブロックする FinOps ガードレールを敷こうと何度も試みました。しかし、これまでの AWS には大きな壁が存在していました。
pricing:GetProducts
「AWS 公式のネイティブ API で、リソースの見積もり明細を投げたら、その場で瞬時に合計金額を返してくれるステートレスな API はないものか……」
そう長年渇望していたクラウドエンジニアに朗報が飛び込んできました。2026年11月20日、AWS は Billing and Cost Management (BCM) Pricing Calculator の新 API として GetUsageLinesEstimatedCost を正式リリースしました。
GetUsageLinesEstimatedCost
▲ Terraform CI/CD および自律AIエージェントが、AWS Pricing Calculator API を介してステートレスに事前コストを即時推計し、予算ガードレールを適用する全体アーキテクチャ
今回登場した GetUsageLinesEstimatedCost は、従来の Pricing Calculator の概念を大きく変える画期的なエンドポイントです。
最大の特徴は、 「AWS アカウントに見積もり(Workload や Scenario)を永続化・保存する必要が一切ない(Stateless)」 という点です。
従来、Pricing Calculator を API 経由で操作しようとすると、まずワークロードを作成して保存し、そこにリソースを紐付け、後から不要になったワークロードを削除するというライフサイクル管理が必要でした。しかし、 GetUsageLinesEstimatedCost は単純なリクエスト・レスポンス型で完結します。
usage
rateType
BEFORE_DISCOUNTS
AFTER_DISCOUNTS
AFTER_DISCOUNTS_AND_COMMITMENTS
key
[a-zA-Z0-9]*
lineItems
errors
Hrs
GB-Mo
estimatedCost
totalCost
このフローにより、重厚な外部 SaaS や複雑なローカル料金キャッシュを持たずとも、GitHub Actions やローカルの CLI 上でわずか数秒で信頼性の高い AWS 公式コスト試算が完了します。
それでは、実際に僕が検証環境で最新の AWS CLI を用いて GetUsageLinesEstimatedCost を実行した際の手順と生ログを見ていきます。
この API を利用するには、 bcm-pricing-calculator の get-usage-lines-estimated-cost をサポートする最新の AWS CLI v2(v2.42.1 以降推奨)または最新の Boto3 SDK が必要です。
bcm-pricing-calculator
get-usage-lines-estimated-cost
# AWS CLI バージョンの確認 $ aws --version aws-cli/2.42.1 Python/3.13.9 Darwin/25.6.0 exe/arm64
開発環境でよくある「t3.medium インスタンス 1台(730時間/月)」「gp3 ボリューム 100GB」「NAT Gateway 1基(730時間/月)」の月額コストを一括推計してみます。
リクエスト用の JSON( usage-request.json )を作成します。ここでパラメータ名は --usage (JSON キーは "usage" )、各明細の key は 10文字以内の英数字(ハイフン不可) である点に注意してください。
usage-request.json
--usage
"usage"
{ "rateType": "BEFORE_DISCOUNTS", "usage": [ { "key": "webEc201", "serviceCode": "AmazonEC2", "usageType": "APN1-BoxUsage:t3.medium", "operation": "RunInstances", "amount": 730.0 }, { "key": "webEbs01", "serviceCode": "AmazonEC2", "usageType": "APN1-EBS:VolumeUsage.gp3", "operation": "CreateVolume", "amount": 100.0 }, { "key": "natGw01", "serviceCode": "AmazonEC2", "usageType": "APN1-NatGateway-Hours", "operation": "CreateNatGateway", "amount": 730.0 } ] }
CLI コマンドを実行します。
$ aws bcm-pricing-calculator get-usage-lines-estimated-cost \ --cli-input-json file://usage-request.json \ --region us-east-1
実行結果として返ってきた生のレスポンスがこちらです。
{ "rateType": "BEFORE_DISCOUNTS", "totalCost": 89.62, "currency": "USD", "lineItems": [ { "key": "webEc201", "serviceCode": "AmazonEC2", "usageType": "APN1-BoxUsage:t3.medium", "operation": "RunInstances", "estimatedCost": { "usageAmount": 730.0, "usageUnit": "Hrs", "cost": 37.96, "currency": "USD" } }, { "key": "webEbs01", "serviceCode": "AmazonEC2", "usageType": "APN1-EBS:VolumeUsage.gp3", "operation": "CreateVolume", "estimatedCost": { "usageAmount": 100.0, "usageUnit": "GB-Mo", "cost": 9.60, "currency": "USD" } }, { "key": "natGw01", "serviceCode": "AmazonEC2", "usageType": "APN1-NatGateway-Hours", "operation": "CreateNatGateway", "estimatedCost": { "usageAmount": 730.0, "usageUnit": "Hrs", "cost": 42.06, "currency": "USD" } } ], "errors": [] }
▲ リモート検証環境にて AWS CLI を実行し、GetUsageLinesEstimatedCost により 3 つの使用量明細から月額 $89.62 の見積もりが 1 リクエストで算出された様子
わずか 0.4 秒ほどの実行時間で、東京リージョンの t3.medium(730 Hrs = $37.96)、gp3 100GB(100 GB-Mo = $9.60)、NAT Gateway の稼働時間(730 Hrs = $42.06)の明細と、合計金額 totalCost: 89.62 が綺麗に出力されました。
totalCost: 89.62
Web コンソールを開いてリソースを1つずつポチポチ追加していた頃を思い出すと、あまりの高速さと手軽さに感動を覚えます。
一見するとシンプルな API ですが、実際に自作スクリプトや CI パイプラインに組み込もうとした際、僕が現場で何度もハマったポイントが 3 点ありました。これから導入する方はぜひ注意してください。
usageType
最も苦戦したのが usageType と key のバリデーション仕様です。
第一に、各明細の識別子 key には min: 0, max: 10, pattern: [a-zA-Z0-9]* (英数字のみ・最大10文字) という厳格な制約があります。Terraform のリソースアドレス(例: aws_instance.web-server )をそのまま key に入れると、アンダースコアやハイフン、文字数超過で ValidationException になります。スクリプト側では連番( line0001 )や短縮ハッシュ(8文字)にマッピングする辞書を用意するのが鉄則です。
min: 0, max: 10, pattern: [a-zA-Z0-9]*
aws_instance.web-server
ValidationException
line0001
第二に、AWS の料金体系において、 usageType にはリージョン固有のプレフィックスが付与されるものと、付与されないものが混在しています。 例えばバージニア北部( us-east-1 )では単に BoxUsage:t3.medium で通るものが、東京リージョン( ap-northeast-1 )では APN1-BoxUsage:t3.medium と先頭に APN1- を付加しなければなりません。
us-east-1
BoxUsage:t3.medium
ap-northeast-1
APN1-BoxUsage:t3.medium
APN1-
存在しない usageType やパラメータ不整合の明細を投げると、以下のように HTTP 200 は返却されるものの、 errors 配列( errorCode : NOT_FOUND または BAD_REQUEST )に隔離されて返却されます。
errorCode
NOT_FOUND
BAD_REQUEST
{ "rateType": "BEFORE_DISCOUNTS", "totalCost": 0.0, "currency": "USD", "lineItems": [], "errors": [ { "key": "webEc201", "serviceCode": "AmazonEC2", "usageType": "APN1-InvalidBox:t3.medium", "operation": "RunInstances", "errorCode": "NOT_FOUND", "errorMessage": "No matching price found for serviceCode AmazonEC2, usageType APN1-InvalidBox:t3.medium, operation RunInstances." } ] }
解決策 : API 全体が 400 番台エラーで落ちるのではなく、 算出不能な明細のみが errors に隔離され、算出できた明細だけが lineItems と totalCost に集計される仕様 になっています(官方ドキュメントでも “Usage lines returned in errors aren’t included” と明記されています)。 そのため、レスポンスを受け取るスクリプトでは、必ず errors の中身をチェックし、1件でもエラーが含まれている場合は「コスト未算出の項目が存在する」として CI を Fail-Closed で停止させるロジックを組む必要があります。
pricing:
bcm-pricing-calculator:
CI/CD 用の IAM ロールや AI エージェントの実行権限を作成する際、従来の癖で Action: "pricing:Get*" を付与してしまい、「 AccessDeniedException 」で弾かれるミスをやらかしました。
Action: "pricing:Get*"
AccessDeniedException
この新しい API のサービスプレフィックスは bcm-pricing-calculator です。
最小権限の IAM ポリシーを作成する場合、以下のように設定します。
{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowGetUsageLinesEstimatedCostOnly", "Effect": "Allow", "Action": [ "bcm-pricing-calculator:GetUsageLinesEstimatedCost" ], "Resource": "*" } ] }
この API はあくまで一時的な計算処理(Read/Query 相当)のみを行うため、アカウント内の既存リソースを変更したり、課金が発生する設定を書き換えるリスクはありません。CI/CD パイプライン用ロールにも安心して付与できます。
大規模な Terraform リポジトリでマルチアカウント・マルチリージョンのインフラを一括管理している場合、 terraform plan の差分から抽出されるリソース明細が 500 件を超えるケースがあります。
terraform plan
--usage パラメータのハードリミットが「1 リクエストあたり最小 1 件・最大 500 件」となっているため、501 件以上を一度に投げると ValidationException: 1 validation error detected: Value at 'usage' failed to satisfy constraint: Member must have length less than or equal to 500 が発生します。
ValidationException: 1 validation error detected: Value at 'usage' failed to satisfy constraint: Member must have length less than or equal to 500
解決策 : 後述する Python ラッパースクリプトのように、明細リストを 500 件単位でスライス(Chunking)し、複数回 API を呼び出して合計金額を合算するユーティリティ関数を設けることで、大規模な差分にも柔軟に対応できます。
それでは、実際に現場で使える Python スクリプトの完全な実装例を紹介します。
このスクリプトは、Terraform の plan JSON や AI エージェントが提案したリソース一覧を受け取り、任意の識別子を 10 文字以内の英数字 key に自動正規化した上で GetUsageLinesEstimatedCost を呼び出し、予算閾値判定を行います。
#!/usr/bin/env python3 """ AWS Pricing Calculator API (GetUsageLinesEstimatedCost) を活用した リアルタイム事前コスト推計&FinOpsガードレールスクリプト """ import sys import boto3 from botocore.exceptions import ClientError def chunk_list(items, chunk_size=500): """リストを指定されたサイズ(最大500件)に分割する""" for i in range(0, len(items), chunk_size): yield items[i : i + chunk_size] def estimate_workload_costs(usage_lines, rate_type="BEFORE_DISCOUNTS", region_name="us-east-1"): """ GetUsageLinesEstimatedCost を呼び出してコストを推計する ※ key の [a-zA-Z0-9]* (最大10文字) 制約への自動マッピングと 500件チャンク分割に対応 """ client = boto3.client("bcm-pricing-calculator", region_name=region_name) total_cost = 0.0 all_line_items = [] all_errors = [] for chunk_idx, chunk in enumerate(chunk_list(usage_lines, 500)): key_map = {} api_usage_payload = [] for idx, item in enumerate(chunk): short_key = f"item{chunk_idx:02d}{idx:04d}" # 10文字以内の英数字 [a-zA-Z0-9]* key_map[short_key] = item.get("label", short_key) api_usage_payload.append({ "key": short_key, "serviceCode": item["serviceCode"], "usageType": item["usageType"], "operation": item["operation"], "amount": float(item["amount"]), }) try: response = client.get_usage_lines_estimated_cost( rateType=rate_type, usage=api_usage_payload, ) total_cost += response.get("totalCost", 0.0) for priced in response.get("lineItems", []): priced["originalLabel"] = key_map.get(priced["key"], priced["key"]) all_line_items.append(priced) for err in response.get("errors", []): err["originalLabel"] = key_map.get(err["key"], err["key"]) all_errors.append(err) except ClientError as e: print(f"[ERROR] API呼び出しに失敗しました: {e}", file=sys.stderr) raise e return { "rateType": rate_type, "totalCost": round(total_cost, 2), "currency": "USD", "lineItems": all_line_items, "errors": all_errors, } def enforce_finops_budget(estimation_result, monthly_budget_threshold=100.0): """予算閾値判定を行い、ガードレールを適用する(エラー明細がある場合は Fail-Closed)""" cost = estimation_result["totalCost"] errors = estimation_result["errors"] print("========================================") print(" FinOps 事前コスト推計レポート ") print("========================================") print(f"適用レートタイプ : {estimation_result['rateType']}") print(f"推計月額コスト合計 : ${cost:.2f} USD") print(f"設定月額予算上限 : ${monthly_budget_threshold:.2f} USD") print(f"評価成功明細件数 : {len(estimation_result['lineItems'])} 件") for item in estimation_result["lineItems"]: est = item.get("estimatedCost", {}) print( f" - [{item['key']}] {item['originalLabel']} ({item['usageType']}): " f"{est.get('usageAmount')} {est.get('usageUnit')} => ${est.get('cost', 0.0):.2f} USD" ) if errors: print(f"\n[BLOCKED] 🚨 未算出エラーが {len(errors)} 件発生しています(Fail-Closed 遮断):") for err in errors: print( f" - [{err.get('key')}] {err.get('originalLabel')} | " f"Code: {err.get('errorCode')} | Msg: {err.get('errorMessage')}" ) return False print("----------------------------------------") if cost > monthly_budget_threshold: print(f"[BLOCKED] 🚨 月額予算上限 (${monthly_budget_threshold:.2f}) を超過しています!") print("インフラ変更の適用を中断します。上位承認者の承認(Human Review)が必要です。") return False else: print(f"[PASSED] ✅ 予算内です。プロビジョニングを継続できます。") return True if __name__ == "__main__": # サンプル使用量データ(東京リージョン想定) sample_usage = [ { "label": "prod-app-server-t3-large", "serviceCode": "AmazonEC2", "usageType": "APN1-BoxUsage:t3.large", "operation": "RunInstances", "amount": 730.0, }, { "label": "prod-app-db-gp3", "serviceCode": "AmazonEC2", "usageType": "APN1-EBS:VolumeUsage.gp3", "operation": "CreateVolume", "amount": 200.0, }, ] result = estimate_workload_costs(sample_usage, rate_type="BEFORE_DISCOUNTS") # 月額予算閾値 $50.0 でチェック is_approved = enforce_finops_budget(result, monthly_budget_threshold=50.0) if not is_approved: sys.exit(1)
▲ リモート検証環境でのエラー隔離テスト(NOT_FOUND / ValidationException)および Python FinOps ガードレールによる予算超過ブロック($95.12 > $50.00)の実行結果
このスクリプトを GitHub Actions のワークフローに組み込めば、プルリクエスト作成時に terraform plan から生成した JSON をパースして渡し、終了コードが 1 の場合は CI を失敗させてマージを抑止する仕組みが即座に完成します。
1
この API の真価は、CI/CD パイプラインにとどまりません。僕が最も大きな可能性を感じているのは、 「自律AIエージェント(Coding Agents / Orchestration Agents)に対するセーフティネット」 としての役割です。
近年、Claude Code や OpenCode、Antigravity などの自律エージェントが、自然言語の指示から Terraform ファイルを生成し、さらには自ら terraform apply まで実行するワークフローが現実味を帯びてきました。
terraform apply
しかし、AI エージェントは「仕様を満たすこと」には極めて忠実ですが、「コスト効率」についてはプロンプトで厳密に指示しない限り無頓着になりがちです。 冗長構成を指示した際に、必要以上に大きなインスタンスタイプ( c6i.4xlarge など)を選択したり、高価なプロビジョンド IOPS(io2)を指定してしまう事故は日常茶飯事です。
c6i.4xlarge
AI エージェントのツールセット(MCP: Model Context Protocol サーバー等)にこの GetUsageLinesEstimatedCost を組み込むことで、以下のような自律的かつ安全な自浄サイクルが実現します。
クラウド運用の主役が人間から AI エージェントへと広がりつつある今、こうしたインフラネイティブなコスト推計 API は、FinOps ガバナンスを担保するための不可欠なピースになると確信しています。
2026年11月20日にリリースされた AWS Pricing Calculator の新 API GetUsageLinesEstimatedCost について、その特徴と実践的な活用法を解説しました。
bcm-pricing-calculator:GetUsageLinesEstimatedCost
なお、 rateType には BEFORE_DISCOUNTS (定価ベース)だけでなく、アカウントの Rate Preferences 設定に応じて AFTER_DISCOUNTS (プライベート割引適用後)や AFTER_DISCOUNTS_AND_COMMITMENTS (Savings Plans / RI 適用後)も指定可能です。ただし Billing Transfer の請求元アカウントでは BEFORE_DISCOUNTS のみに制限される点や、複数メンバーアカウント間でのコミットメント按分の見え方など、実運用の中でどのレートタイプを CI の閾値基準にするのが最もブレないか、今後も検証を重ねていきたいと思います。
皆さんもぜひ、日々の IaC パイプラインや AI エージェントの実行環境にこの新しい API を組み込んで、月末の請求書に怯えない快適なクラウド運用を実現してみてください。
日本株・グローバル企業の適時開示・決算速報をAIクオンツ解析。市場モメンタムや注目銘柄をリアルタイムに可視化するデータポータルです。
本番さながらのAI電話で初通話もデート誘いも余裕に。通話中の対話をリアルタイム解析し、最適な切り返しや好感度アップの助言を即座にサジェスト。24時間いつでも通話練習が可能です(無料体験あり・1レッスン 約150円〜)。
レシートを撮影するだけでGemini AIが品目・金額を高精度OCR解析。LINEログインで友人との面倒な立替・割り勘計算を美しく完結します。
占い師・執事・バーテンダーなどのAIキャラクターが進行役となり、お題やゲームを出題。集まる時間を最高にエキサイティングにするiOSアプリ。
人工甘味料や添加物のNG成分除外フィルターと、有効成分あたりの実質単価を徹底比較・可視化するヘルスケア比較データベースです。