請求可能使用量API:Cloudflareのためのプログラムによるコスト可視化
The Billable Usage API: programmatic cost visibility for Cloudflare (blog.cloudflare.com)
要約
Cloudflareは、エージェントによる自動化されたインフラ管理に対応するため、新しい請求可能使用量APIをリリースしました。このAPIは、単一のエンドポイントを通じて、アカウントの使用量とコストを製品別、サービス期間別にプログラムで取得できます。Workers、R2、D1、Workers AIなど、すべての従量課金製品をカバーし、FinOps Open Cost and Usage Specification (FOCUS) と互換性のあるデータ形式で提供されます。これにより、開発者や財務チームは、コストをリアルタイムで把握し、他のクラウドプロバイダーのデータと統合することが容易になります。
全文翻訳
Billable Usage APIの紹介:Cloudflareのプログラムによるコスト可視化
Agents Weekは、エージェントがコードを書き、Workersをデプロイし、インフラストラクチャをプロビジョニングするという、すでに進行中のシフトについてです。そのシフトは、あなたが見る必要があるものを変えます。プログラムがCloudflareアカウントで費用を発生させている場合、それが何にいくら費やしているかを知る必要があります。それは、1日を通して、製品ごとに、別のプログラムが消費できる形式でです。ダッシュボードは人間にとっては適切な回答です。自動化にとっては適切な回答ではありません。
そこで、セルフサービスアカウント向けの新しいBillable Usage APIをリリースします。これは、アカウントの利用状況とコストを、製品別およびサービス期間別に分解して返す単一のエンドポイントです。Workers、R2、D1、Workers AI、Vectorize、Images、Streamを含む、アカウント上のすべての従量課金制Cloudflare製品を、1回の呼び出しでカバーします。すでにFinOpsツールチェーンで作業している場合、カラム名は見慣れたものになるはずです。
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/billable-usage \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/billable-usage?from=2026-02-01&to=2026-02-15" \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
Content-Type: application/jsonのHTTP 200 OKと、レスポンスボディ内の利用状況の行が返されます。現在、利用状況とコストデータは毎日更新されており、よりリアルタイムなデータの提供に向けて取り組んでいます。
返される内容
レスポンスの各行は、アカウント上の1つの製品の1つの課金期間です。
ServiceNameおよびServiceFamilyName— どの製品か(「Workers」ファミリーの「Workers Standard」、「R2」の「R2 Storage」など)。ChargePeriodStart/ChargePeriodEnd— この行がカバーする期間。PricingQuantityおよびConsumedUnit— 請求単位での使用量(GB-month、GB-second、リクエストなど)。ContractedCost— その期間のコスト(BillingCurrency単位)。CumulatedContractedCost— 請求期間の累計。ZoneId/ZoneName— 利用状況が特定のゾーンに紐付けられている場合。
これらのほとんどは、FinOps Open Cost and Usage Specification (FOCUS)の列に直接マッピングされるため、チームがすでに他のプロバイダーからFOCUSデータをインジェストしている場合、名前とセマンティクスは馴染み深いものになるでしょう。
| Cloudflareフィールド | FOCUSカラム | 注記 |
|---|---|---|
BillingCurrency | BillingCurrency | 完全一致。 |
BillingPeriodStart | BillingPeriodStart | 完全一致。 |
ChargePeriodStart / ChargePeriodEnd | ChargePeriodStart / ChargePeriodEnd | 完全一致。 |
ServiceName | ServiceName | 完全一致。 |
ConsumedQuantity / ConsumedUnit | ConsumedQuantity / ConsumedUnit | 完全一致。 |
PricingQuantity | PricingQuantity | 完全一致。 |
ContractedCost | ContractedCost | 完全一致。 |
ServiceFamilyName | (ServiceCategoryに近い) | Cloudflareネイティブのグループ化。FOCUSは管理語彙を使用します。 |
CumulatedContractedCost | (派生) | 利便性のためのフィールド — FOCUSでは累計はクエリの関心事として扱われます。 |
ZoneId / ZoneName | (ResourceId / ResourceNameに近い) | 該当する場合、ゾーンスコープの識別子。 |
レスポンスは標準のCloudflare APIエンベロープを使用します。resultは行の配列(製品ごと、課金期間ごと)で、success、errors、messagesと共に返されます。
{
"result": [
{
"BillingCurrency": "USD",
"BillingPeriodStart": "2025-02-01T00:00:00Z",
"ChargePeriodStart": "2025-02-01T00:00:00Z",
"ChargePeriodEnd": "2025-02-28T23:59:59Z",
"ServiceName": "Workers Standard",
"ServiceFamilyName": "Workers",
"ConsumedQuantity": 150000,
"ConsumedUnit": "GB-months",
"ContractedCost": 0.75,
"CumulatedContractedCost": 2.25
}
],
"success": true,
"errors": [],
"messages": []
}
FOCUSにおける現状
FOCUS命名規則への準拠は意図的な選択でした。AWS、Azure、Google Cloud、Oracle、および多くのSaaSプロバイダーはすでにFOCUS形式のエクスポートを発行しており、あらゆる真剣なコスト管理ツールがそれに対応しています。とはいえ、まだ完全な準拠を主張するわけではありません。仕様で要求されているいくつかのカラムは、現時点ではペイロードに含まれていません。そこへ到達することはロードマップにあります。これは最初のステップと見なしてください。現在は馴染みのある形式で、次は完全な準拠を目指します。
Cloudflareの支出を、他のクラウド支出と並べて:Vantageとのパートナーシップ
インフラストラクチャコスト管理プラットフォームであるVantageと提携し、ネイティブなCloudflareインテグレーションを提供します。Vantageは、AI、クラウド、SaaSプロバイダーなど30以上のプロバイダーからコストと利用状況データをインジェストし、レポート作成、配分、最適化のために単一のビューに集約します。このインテグレーションにより、あなたの利用状況は、すでに他のインフラストラクチャで使用しているコストレポート、予算、コストアラートと同じものに流れ込みます。
Vantageは、Billing Readアクセス権を持つ読み取り専用APIトークンを使用してCloudflareに接続します。接続後、VantageはBillable Usageデータを毎日取得し、製品(WorkersやR2など)、ゾーン、アカウント別に分解するため、どの製品が支出を牽引しているかを確認し、その背後にあるチームやサービスに費用を配分できます。
このインテグレーションがサポートするワークフローのいくつかです。
- プロバイダーを横断した配分。 Cloudflareの支出を製品、ゾーン、アカウント別にグループ化し、Virtual Tagsを使用してAWS、Azure、その他のプロバイダーのコストと並べてチームや製品ライン別に配分できます。すべて単一のレポートで。
- 異常検知。 Vantage Cost Alertsは、接続されているすべてのプロバイダーを監視し、支出がベースラインから逸脱した場合にSlackまたはEメールで通知するため、WorkersやR2の支出の変更は、他のプロバイダーの場合と同じように表示されます。
- FinOpsエージェントとMCP。 Vantageのコンソール内FinOpsエージェントに「先週、すべてのプロバイダーで最大のコストドライバーは何でしたか?」といった質問をしたり、VantageのホストされたMCPサーバーを介してClaudeやChatGPTから同じデータをクエリしたりできます。Cloudflareの支出は、接続されている他のプロバイダーと共に含まれます。
VantageコンソールでCloudflareアカウントを接続すると、コストが実行中の他のすべてのものの隣に表示されます。手動エクスポート、請求書アップロード、または個別のダッシュボードの維持は不要です。
このFOCUS標準化APIは、他のFintechツールとも連携します。
なぜこれを構築したのか
エージェントはコードを書くだけではありません。Workersをデプロイし、R2バケットをプロビジョニングし、D1データベースを管理します。Cloudflareアカウントへのプログラムアクセスを許可する場合、それがいくらかかっているかについてのプログラムによる可視性が必要です。月末ではなく、1日を通して、製品ごとに、プログラムが実際に消費できる形式でです。
Billable Usage APIはその形式です。そして、顧客は長年プログラムによる利用状況を求めていました。財務チームは支出を独自のシステムに取り込み、内部プロジェクト、チーム、さらにはエンド顧客に費用を配分したいと考えています。開発者はスクリプトにドロップできるcurlを求めています。これらのワークフローのすべてが、かつてはスクリーンショットや手動エクスポートを伴っていました。今ではHTTP呼び出し、またはVantageでの設定です。
今後の予定
- より詳細な時間枠。 現在、APIは課金期間ごとの行を返します。これはほとんどの製品で毎日です。製品に応じて、よりリアルタイムな内訳を検討しています。
- 予測。
CumulatedContractedCostは、現在の請求サイクルでの支出がどこにあるかを示します。最終的にどこに落ち着くかを予測するのに役立ちたいと考えています。そして、アカウントレベルだけでなく、製品レベルでも。 - エンタープライズカバレッジ。 この最初のリリースはセルフサービスのみです。エンタープライズ契約向けの同等のエクスペリエンスも開発中です。
試してみる
エンドポイントは本日、すべてのセルフサービスアカウントで利用可能です。APIトークンにBilling Read権限を付与し、curlでポイントすると、現在の請求期間が製品別に分解されて返されます。完全なリファレンスはCloudflare APIドキュメントで入手できます。他のクラウド支出と並べて表示するには、VantageコンソールでCloudflareアカウントを接続してください。
Cloudflareは、ネットワーク上でスタックのより多くの部分を実行しやすくするために長年取り組んできました。それにかかるコストを、Cloudflare上でも、他のすべての場所でも、同様に見やすくする時が来ました。