Kanji
・雲端架構工程師 / 自由職業 ・1993年出生 ・愛媛縣出身 / 現居東京都澀谷區 ・5年 AWS 實戰經驗 個人檔案詳情
目錄
ap-northeast-1
usageType
key
在推進企業雲端遷移與 AWS 基礎架構建置的過程中,最讓我頭痛的莫過於「部署前成本試算的繁瑣流程,以及月底看到帳單那一刻的驚嚇」。
如今開發人員可以輕鬆地用 Terraform 或 AWS CDK 建立資源;甚至只需用自然語言向自主 AI 程式設計代理(如 Antigravity、Claude Code、OpenCode 等)下達一句「幫我建置一套測試用的預發環境」,短短幾分鐘內,VPC、NAT Gateway、EKS 叢集、測試 RDS 與跳板機 EC2 就會被自動編排完成。
但這種高效率背後的隱憂,就是「無意間啟動過高規格或昂貴計費的資源」。 在先前的一個內部測試專案中,開發人員在多可用區(Multi-AZ)冗餘部署了 NAT Gateway,測試容器頻繁拉取數 GB 的映像檔並傳輸海量日誌,結果短短一週內資料傳輸與閘道器小時費就飆升了數百美元,直到月底觸發帳單告警才緊急清理。
為了防止此類事故,我曾多次嘗試在 Pull Request(PR)階段自動計算「本次基礎架構變更將增加多少月度費用」,並在超出預算時自動攔截 CI 的 FinOps 護欄。但長期以來,AWS 原生工具鏈存在明顯短板:
pricing:GetProducts
「如果 AWS 能提供一個官方原生的無狀態(Stateless)API,只需把規劃的用量明細發過去,就能當場回傳彙總估算金額該多好……」
2026 年 11 月 20 日,AWS 終於回應了雲端架構師們的期盼,在 AWS Billing and Cost Management (BCM) Pricing Calculator 中正式推出了全新 API: GetUsageLinesEstimatedCost 。
GetUsageLinesEstimatedCost
▲ 整體架構:Terraform CI/CD 與自主 AI 代理透過 AWS Pricing Calculator API 進行無狀態即時成本推估並執行預算護欄
新發布的 GetUsageLinesEstimatedCost 徹底改變了以往使用 AWS Pricing Calculator 的方式。
它最核心的特性是 「完全無狀態(Stateless)——完全不需要在 AWS 帳號中持久化或儲存任何估算物件(Workload 或 Scenario)」 。
過去若想透過 API 操作 Pricing Calculator,必須先建立並儲存一個 Workload 物件,將資源綁定上去,事後還要清理廢棄的估算紀錄。而 GetUsageLinesEstimatedCost 採用純粹的請求-回應模式,即查即走。
usage
rateType
BEFORE_DISCOUNTS
AFTER_DISCOUNTS
AFTER_DISCOUNTS_AND_COMMITMENTS
[a-zA-Z0-9]*
lineItems
errors
Hrs
GB-Mo
estimatedCost
totalCost
以下展示我在遠端測試環境中,使用最新 AWS CLI v2 呼叫 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 --version aws-cli/2.42.1 Python/3.13.9 Darwin/25.6.0 exe/arm64
我們來試算一套東京區域( ap-northeast-1 )常見的開發基準環境:1 台 t3.medium 執行個體(730 小時/月)、100 GB gp3 磁碟區,以及 1 個 NAT Gateway(730 小時/月)。
t3.medium
gp3
建立請求 JSON 檔案( usage-request.json )。注意頂層陣列欄位名為 "usage" (CLI 參數為 --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 } ] }
執行 AWS CLI 指令:
$ aws bcm-pricing-calculator get-usage-lines-estimated-cost \ --cli-input-json file://usage-request.json \ --region us-east-1
API 回傳的原始 JSON 回應如下:
{ "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": [] }
▲ 遠端測試環境實機終端機截圖:單次呼叫 GetUsageLinesEstimatedCost 在 384ms 內算出 3 項明細共計 $89.62/月
在將該 API 整合至自動化指令碼的過程中,有三個關鍵陷阱需要特別留意:
首先是 key 欄位的校驗規則: min: 0, max: 10, pattern: [a-zA-Z0-9]* (僅限英文字母與數字,最長 10 個字元) 。若直接將 Terraform 資源位址(如 aws_instance.web-server )傳給 key ,會因包含底線、連字號及超出 10 字元而拋出 ValidationException 。因此在封裝指令碼中,必須將可讀標籤映射為短編號(如 item000001 )。
min: 0, max: 10, pattern: [a-zA-Z0-9]*
aws_instance.web-server
ValidationException
item000001
其次是 usageType 的區域縮寫前綴。美東( us-east-1 )通常不帶前綴( BoxUsage:t3.medium ),而東京區域( ap-northeast-1 )則必須加上 APN1- 前綴(即 APN1-BoxUsage:t3.medium )。
us-east-1
BoxUsage:t3.medium
APN1-
APN1-BoxUsage:t3.medium
若傳入不匹配的 usageType ,API 依然回傳 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." } ] }
解決方案 : 官方文件明確指出 errors 中的明細不會計入 totalCost 。因此用戶端指令碼必須嚴格檢查 errors ,只要存在任何一筆錯誤,就必須依 Fail-Closed 原則阻斷管線。
bcm-pricing-calculator:
pricing:
最小權限 IAM 政策配置如下:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowGetUsageLinesEstimatedCostOnly", "Effect": "Allow", "Action": [ "bcm-pricing-calculator:GetUsageLinesEstimatedCost" ], "Resource": "*" } ] }
單次請求上限為 500 筆 usage 明細,超過時需在用戶端按 500 筆為單位進行切片並累加 totalCost 。
以下為可直接用於生產管線的 Python 指令碼,內建 10 字元 key 自動映射、500 筆分塊請求以及 Fail-Closed 預算閾值校驗:
#!/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): 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"): 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}" 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): 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'])} 筆") if errors: print(f"\n[BLOCKED] 🚨 存在 {len(errors)} 筆未成功計價錯誤(Fail-Closed 阻斷)") return False if cost > monthly_budget_threshold: print(f"[BLOCKED] 🚨 超出月度預算上限 (${monthly_budget_threshold:.2f})!需人工審批。") 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") if not enforce_finops_budget(result, monthly_budget_threshold=50.0): sys.exit(1)
▲ 遠端驗證環境實測:錯誤隔離驗證(NOT_FOUND)、CloudTrail 稽核追蹤與 Python FinOps 護欄攔截超預算變更($95.12 > $50.00)
除了傳統 CI/CD,這項 API 最具變革意義的場景是作為 「自主 AI 程式設計代理(Autonomous Coding Agents)的財務安全網」 。將 GetUsageLinesEstimatedCost 封裝為 MCP 工具交給代理後,代理可以在執行 terraform apply 前自我試算成本;若超預算則自動切換為 Graviton 執行個體或 gp3 儲存,只有在無法進一步最佳化時才升級請求人工審批。
terraform apply
bcm-pricing-calculator:GetUsageLinesEstimatedCost
Real-time AI quant analysis of corporate earnings reports.
提供逼真 AI 模擬通話與多維反饋,結合 16 講實戰社交學院與工作室級 AI 肖像生成,全面提升社交互動品質。
拍發票即可完成高精度智慧拆單,支援 LINE 登入無縫結算團隊聚會支出,告別繁雜帳單分攤。
占卜師、管家、調酒師等 AI 角色即時引導話題與聚會遊戲,讓線下與線上聚餐氛圍瞬間升溫。
人工甘味料や添加物のNG除外と有効成分あたりの実質単価比較データベース。