可计费使用 API:Cloudflare 的程序化成本可见性
代理周是关于已经在进行的转变:代理编写代码、部署 Workers,并代表您配置基础设施。这一转变改变了您所需查看的事物。如果某个程序在您的 Cloudflare 帐户中花费了资金,您需要知道它花费了什么;全天按产品分类,以便其他程序可以使用的形状。仪表板是人类的正确答案,但并不适合自动化。因此,我们推出了新的可计费使用 API,适用于自助服务帐户:一个返回您帐户使用情况和成本的单一端点,按产品和服务期间分类。它涵盖帐户中每个基于使用的 Cloudflare 产品,包括 Workers、R2、D1、Workers AI、Vectorize、Images 和 Stream,所有这些都通过一个请求获得。如果您已经在 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" 您将收到一个 HTTP 200 OK 响应,内容类型为 application / json,响应体中包含使用情况行。今天,使用和成本数据每天更新,同时我们致力于提供更多实时数据。每一行响应表示您的帐户上一个产品的一个收费周期。ServiceName 和 ServiceFamilyName - 表示哪个产品(“Workers”系列下的“Workers Standard”,“R2”下的“R2 Storage”等)。ChargePeriodStart / ChargePeriodEnd - 该行覆盖的时间段。PricingQuantity 和 ConsumedUnit - 您使用了多少,以我们计费的计量单位(GB-月,GB-秒,请求等)。ContractedCost - 该时段的费用,以 BillingCurrency 计。CumulatedPricingQuantity 和 CumulatedContractedCost - 计费期间的累计总额。ZoneId / ZoneName - 当使用归因于特定区域时。大多数这些字段直接映射到 FinOps 开放成本和使用规格(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 封装——结果为行数组,每个产品每个收费期一行,外加 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 是一个基础设施成本管理平台,能够从超过 30 个供应商(包括 AI、云和 SaaS 提供商)获取成本和使用数据,并将其整合为单一视图,以便于报告、分配和优化。通过这一集成,您的使用情况会流入您已用于其余基础设施的相同成本报告、预算和成本警报中。Vantage 使用具有计费读取访问权限的只读 API 令牌连接到 Cloudflare。连接后,Vantage 每日提取您的可计费使用数据,并按产品(如 Workers 和 R2)、区域和帐户进行细分,以便您可以查看哪些产品推动了您的支出,并将其归因于背后的团队和服务。此集成支持的一些工作流:跨提供者分配。按产品、区域和帐户对 Cloudflare 支出进行分组,然后使用虚拟标签按团队或其他标识符进行分配。
本站免费、广告极少。如果觉得有帮助,可以请我们喝杯咖啡 —— 任何金额都对持续运营有实际帮助。
☕请我喝杯咖啡