請求可能使用量API：Cloudflareのためのプログラムによるコスト可視化

Agents Weekは、エージェントがコードを書き、Workersをデプロイし、あなたの代わりにインフラをプロビジョニングするという、すでに進行中のシフトについてです。そのシフトは、あなたが見る必要があるものを変えます。プログラムがCloudflareアカウントで費用を発生させている場合、それが何に費用をかけているのか、一日を通して、製品ごとに、別のプログラムが消費できる形式で知る必要があります。ダッシュボードは人間にとっては正しい答えですが、自動化にとってはそうではありません。 そのため、セルフサービスアカウント向けの新しい請求可能使用量APIをローンチします。これは、アカウントの使用量とコストを製品別およびサービス期間別に返す単一のエンドポイントです。Workers、R2、D1、Workers AI、Vectorize、Images、Streamなど、アカウント上のすべての従量課金Cloudflare製品を、1回の呼び出しでカバーします。すでにFinOpsツールチェーンで作業している場合、カラム名は見慣れたものになるはずです。 ```bash 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" ``` HTTP 200 OKとContent-Type: application/json、そしてレスポンスボディに使用量行が返されます。現在、使用量とコストのデータは毎日更新されており、よりリアルタイムなデータの提供に向けて取り組んでいます。 返されるもの レスポンスの各行は、アカウント上の1つの製品の1つの課金期間です。 * ServiceName および ServiceFamilyName — どの製品か（「Workers」ファミリーの下の「Workers Standard」、「R2」の下の「R2 Storage」など）。 * ChargePeriodStart / ChargePeriodEnd — この行がカバーする期間。 * PricingQuantity および ConsumedUnit — 請求単位（GB-月、GB-秒、リクエストなど）での使用量。 * ContractedCost — その期間の費用（BillingCurrency）。 * CumulatedPricingQuantity および 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 / リソース名に近い) | 該当する場合のゾーンスコープ識別子。 | レスポンスは標準のCloudflare APIエンベロープを使用します。結果は、製品ごとの行の配列、成功、エラー、メッセージとともに返されます。 ```json { "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は、請求読み取りアクセス権を持つ読み取り専用APIトークンを使用してCloudflareに接続します。接続後、Vantageは毎日請求可能使用量データを取得し、製品（WorkersやR2など）、ゾーン、アカウント別に内訳を表示するため、どの製品が支出を牽引しているかを確認し、それらを背後にあるチームやサービスに帰属させることができます。 この統合がサポートするワークフローのいくつかを紹介します。 * クロスプロバイダー割り当て。Cloudflareの支出を製品、ゾーン、アカウント別にグループ化し、仮想タグを使用してAWS、Azure、その他のプロバイダーのコストと並んでチームまたは製品ライン別に割り当てます。すべて単一のレポートで行えます。 * 異常検出。Vantageコストアラートは、接続されているすべてのプロバイダーを監視し、支出がベースラインから逸脱した場合にSlackまたはEメールで通知します。これにより、WorkersまたはR2の支出の変更が、他のプロバイダーの場合と同様に表示されます。 * FinOpsエージェントとMCP。Vantageのコンソール内FinOpsエージェントに、「先週、すべてのプロバイダーで最大のコストドライバーは何でしたか？」のような質問をしたり、VantageのホストされたMCPサーバーを通じてClaudeまたはChatGPTから同じデータをクエリしたりできます。Cloudflareの支出は、他の接続されたプロバイダーと一緒に含まれます。 VantageコンソールでCloudflareアカウントを接続すると、コストが他のすべての実行中のものと並んで表示されます。手動のエクスポート、請求書のアップロード、または維持する個別のダッシュボードはありません。このFOCUS標準化APIは、他のFintechツールとも連携します。 なぜこれを構築したのか エージェントはコードを書くだけではありません。彼らはWorkersをデプロイし、R2バケットをプロビジョニングし、D1データベースを管理します。Cloudflareアカウントへのプログラムアクセスを許可する場合、それがあなたにどれだけ費用がかかっているかのプログラムによる可視性が必要です。月末ではなく、一日を通して、製品ごとに、プログラムが実際に消費できる形式で。 請求可能使用量APIはその形式です。そして、顧客は長年プログラムによる使用量を求めてきました。財務チームは、支出を独自のシステムに取り込み、内部プロジェクト、チーム、さらにはエンド顧客にコストを帰属させたいと考えています。開発者は、スクリプトにドロップできるcurlを求めています。それらのワークフローのすべては、かつてスクリーンショットまたは手動エクスポートを伴っていました。今ではHTTP呼び出し、またはVantageでの設定です。 次は何ですか * より詳細な時間ウィンドウ。現在、APIは課金期間の行を返しますが、ほとんどの製品では毎日です。意味のある製品については、よりリアルタイムな内訳を検討しています。 * 予測。CumulatedContractedCostは、現在の請求サイクルでの支出がどこにあるかを示します。最終的にどこに落ち着くかを予測するのに役立ちたいと考えています。そして、アカウントレベルだけでなく、製品レベルでも。 * エンタープライズカバレッジ。この最初のリリースはセルフサービスのみです。エンタープライズ契約向けの同等のエクスペリエンスが開発中です。 試してみてください エンドポイントは本日、すべてのセルフサービスアカウントで利用可能です。Billing Read権限を持つAPIトークンを取得し、curlでポイントすると、現在の請求期間が製品別に内訳表示されたものが返されます。完全なリファレンスはCloudflare APIドキュメントで入手できます。他のクラウド支出と並べて表示するには、VantageコンソールでCloudflareアカウントを接続してください。 Cloudflareは、ネットワーク上でスタックのより多くの部分を実行することを容易にするために長年努力してきました。今、Cloudflare上でも、他のすべての場所でも、それがどれだけ費用がかかるかを見えるようにすることが、同じくらい容易になる時です。