Presentazione dell'API per l'utilizzo fatturabile: visibilità programmatica dei costi per Cloudflare

La Agents Week riguarda il cambiamento già in corso: riguarda il cambiamento già in atto: gli agenti scrivono codice, implementano i Worker e predispongono l'infrastruttura per tuo conto. Questo cambiamento modifica ciò che devi vedere. Se un programma sta spendendo denaro nel tuo account Cloudflare, devi sapere cosa sta spendendo: nell'arco della giornata, per ogni singolo prodotto e in un formato che un altro programma possa utilizzare. Il pannello di controllo è la giusta soluzione per gli operatori umani, ma non per l'automazione.

Stiamo quindi lanciando una nuova API per l'utilizzo fatturabile per gli account self-service: un singolo endpoint che restituisce l'utilizzo e il costo del tuo account, suddivisi per prodotto e per periodo di servizio. Tale API copre tutti i prodotti Cloudflare basati sull'utilizzo presenti sull'account, inclusi Workers, R2, D1, Workers AI, Vectorize, Images e Stream, il tutto con una sola chiamata. E se già lavori con una suite di strumenti FinOps, i nomi delle colonne ti risulteranno familiari.

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"

Riceverai un HTTP 200 OK con Content-Type: application/json e le righe di utilizzo nel corpo della risposta. Attualmente, i dati relativi all'utilizzo e ai costi vengono aggiornati quotidianamente, mentre lavoriamo per fornire dati sempre più in tempo reale.

Cosa viene restituito

Ogni riga nella risposta corrisponde a un periodo di addebito per un prodotto presente sul tuo account.

• ServiceName e ServiceFamilyName: il prodotto ("Workers Standard" nella famiglia "Workers", "R2 Storage" in "R2" e così via).
• ChargePeriodStart / ChargePeriodEnd: il periodo coperto da questa riga.
• PricingQuantity e ConsumedUnit: quanto hai utilizzato, nell'unità di misura che usiamo per la fatturazione (GB/mesi, GB/secondi, richieste e così via).
• ContractedCost: il costo di quel periodo, in BillingCurrency.
• CumulatedPricingQuantity e CumulatedContractedCost: i totali progressivi per il periodo di fatturazione.
• ZoneId / ZoneName: quando l'utilizzo è attribuito a una zona specifica.

La maggior parte di queste corrisponde direttamente alle colonne della FinOps Open Cost and Usage Specification (FOCUS), pertanto, se il tuo team sta già importando dati FOCUS da un altro provider, i nomi e la terminologia dovrebbero risultarti familiari:

Le risposte utilizzano il formato standard dell'API di Cloudflare: result è un array di righe, una per prodotto per periodo di addebito, insieme a success, errors e 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": []
}

Dove siamo su FOCUS

La scelta di utilizzare la denominazione FOCUS è stata deliberata. AWS, Azure, Google Cloud, Oracle e un elenco sempre più lungo di provider SaaS pubblicano già esportazioni in formato FOCUS, e tutti i principali strumenti di gestione dei costi lo utilizzano. Ciò detto, non possiamo ancora affermare di essere pienamente conformi: alcune colonne richieste dalle specifiche non sono attualmente presenti nel payload. Raggiungere questo obiettivo è nella nostra tabella di marcia. Consideriamo questo il primo passo: ora ha una forma familiare, poi ci sarà la piena conformità.

Spesa su Cloudflare, accanto al resto della spesa per il cloud: la nostra partnership con Vantage

Abbiamo stretto una partnership con ​Vantage per un'integrazione nativa con Cloudflare. Vantage è una piattaforma per la gestione dei costi dell'infrastruttura che acquisisce dati relativi a costi e utilizzo da oltre 30 provider, tra cui provider di intelligenza artificiale, cloud e SaaS, e li riunisce in un'unica visualizzazione per la creazione di report, l'allocazione e l'ottimizzazione. Grazie a questa integrazione, i dati relativi al tuo utilizzo confluiranno negli stessi report sui costi, budget e avvisi sui costi che già utilizzi per il resto della tua infrastruttura.

Vantage si connette a Cloudflare utilizzando un token API di sola lettura con accesso di sola lettura ai dati di fatturazione. Una volta stabilita la connessione, Vantage raccoglie quotidianamente i dati di utilizzo fatturabile e li suddivide per prodotto (come Workers e R2), zona e account, consentendoti di individuare i prodotti che generano la spesa e di attribuirla ai team e ai servizi responsabili.

Ecco alcuni dei flussi di lavoro supportati da questa integrazione:

• Allocazione tra provider. Raggruppa la spesa Cloudflare per prodotto, zona e account, quindi utilizza i tag virtuali per allocarla per team o linea di prodotto insieme ai costi di AWS, Azure e altri provider, tutto in un unico report.
• Rilevamento delle anomalie. Gli avvisi di costo di Vantage monitorano ogni provider connesso e ti notificano tramite Slack o e-mail quando la spesa si discosta dal valore di riferimento, in modo che una variazione nella spesa per Workers o R2 venga visualizzata nello stesso modo in cui viene visualizzata per qualsiasi altro provider.
• Agenti FinOps e MCP. Poni all'agente Vantage FinOps nella console una domanda come "Qual è stato il nostro principale fattore di costo la scorsa settimana per ogni provider?" oppure interroga gli stessi dati da Claude o ChatGPT tramite il server MCP ospitato da Vantage. La spesa per Cloudflare è inclusa insieme a quella per gli altri provider connessi.

Collega il tuo account Cloudflare nella ​console Vantage e i tuoi costi appariranno accanto a tutto ciò che utilizzi. Non sono previste esportazioni manuali, caricamenti di fatture o pannelli di controllo separati da gestire. 

Questa API standardizzata di FOCUS funziona anche con altri strumenti Fintech.

Perché l'abbiamo creata

Gli agenti fanno molto più che scrivere codice. Implementano Workers, forniscono bucket R2 e gestiscono database D1. Quando concedi l'accesso programmatico al tuo account Cloudflare, hai bisogno di visibilità programmatica sui costi che ne derivano. Non alla fine del mese, ma durante tutta la giornata, per prodotto, in un formato che un programma possa effettivamente utilizzare.

L'API per l'utilizzo fatturabile ha quel formato. Da anni i clienti ci chiedono una soluzione di utilizzo programmatico. I team finanziari desiderano importare le spese nei propri sistemi e attribuire i costi a progetti interni, team e persino ai clienti finali. Gli sviluppatori desiderano un comando curl che possano inserire in uno script. Ciascuno di questi flussi di lavoro prevedeva in precedenza uno screenshot o un'esportazione manuale. Ora si tratta di una chiamata HTTP o di una configurazione in Vantage.

Cosa succederà dopo?

• Finestra temporale più dettagliata. Oggi l'API restituisce righe relative al periodo di fatturazione, che per la maggior parte dei prodotti è giornaliero. Stiamo valutando la possibilità di fornire maggiori dettagli in tempo reale per i prodotti in cui ciò risulta opportuno.
• Previsioni. CumulatedContractedCost ti indica a che punto della tua spesa ti trovi nel ciclo di fatturazione corrente. Vogliamo aiutarti a prevedere dove finirai e non solo a livello di account, ma anche a livello di prodotto.
• Copertura Enterprise. Questa prima versione è disponibile solo in modalità self-service. È in fase di sviluppo un'esperienza equivalente per i contratti Enterprise.

Provala

L'endpoint è attivo da oggi per tutti gli account self-service. Ottieni un token API con l'autorizzazione Billing Read, punta il tuo curl su di esso e riceverai il tuo periodo di fatturazione corrente suddiviso per prodotto. Il riferimento completo è disponibile nella documentazione dell'API di Cloudflare. Per visualizzarlo insieme al resto della tua spesa cloud, collega il tuo account Cloudflare nella ​console Vantage.

Cloudflare ha dedicato anni a semplificare l'esecuzione di un numero sempre maggiore di componenti della tua infrastruttura sulla nostra rete. È ora di rendere altrettanto semplice vedere quanto ti costa tutto questo, su Cloudflare e ovunque desideri.