Panoramica delle API di creazione di report per i clienti Enterprise

Le API di creazione di report consentono ai clienti Enterprise di Azure di estrarre i dati di fatturazione e sull'uso a livello di codice per inserirli negli strumenti di analisi preferiti.

Abilitazione dell'API per l'accesso ai dati

  • Generare o recuperare la chiave API: accedere a Enterprise Portal e seguire l'esercitazione disponibile nella sezione della Guida relativa alle API di creazione di report. La prima sezione in tale articolo illustra come generare o recuperare la chiave API per la registrazione specificata.
  • Passare le chiavi nell'API - La chiave API deve essere passata per ogni chiamata per l'autenticazione e l'autorizzazione. La proprietà seguente deve essere passata alle intestazioni HTTP:
Chiave intestazione necessaria Valore
Authorization Specificare il valore nel formato: bearer {API_KEY}
Esempio: bearer eyr....09

API per l'uso

Per le API descritte di seguito, qui è disponibile un endpoint Swagger che deve consentire una facile analisi dell'API e la possibilità di generare SDK client tramite AutoRest o Swagger CodeGen. I dati a partire dal 1° maggio 2014 sono disponibili tramite questa API.

  • Saldi e riepilogo - L'API per saldi e riepilogo offre un riepilogo mensile delle informazioni su saldi, nuovi acquisti, addebiti per il servizio Azure Marketplace e spese per modifiche e da pagare in eccedenza.

  • Dettagli sull'uso - L'API per dettagli sull'uso offre un'analisi giornaliera dettagliata delle quantità usate e delle spese stimate in relazione a una registrazione. Il risultato include anche informazioni su istanze, contatori e reparti. Le query sull'API possono essere eseguite in base al periodo di fatturazione oppure in base a un intervallo definito da date di inizio e di fine specificate.

  • Spese per Marketplace Store - L'API per spese per il Marketplace Store restituisce le spese giornaliere dettagliate in base all'uso correlate al Marketplace per il periodo di fatturazione specificato o per le date di inizio e fine indicate (le spese una tantum non sono incluse).

  • Elenco prezzi - L'API elenco prezzi offre la tariffa applicabile per ogni contatore per la registrazione e il periodo di fatturazione specificati.

API di supporto

Elenco periodi di fatturazione - L'API per periodi di fatturazione restituisce un elenco di periodi di fatturazione contenente i dati sull'uso per la registrazione specificata in ordine cronologico inverso. Ogni periodo contiene una proprietà che punta alla route API per i quattro set di dati, ovvero BalanceSummary, UsageDetails, MarketplaceCharges e PriceSheet.

Codici di risposta dell'API

Codice di stato della risposta Message Descrizione
200 OK Nessun errore
401 Non autorizzata Chiave API non trovata, non valida, scaduta e così via
404 Non disponibile Endpoint del report non trovato
400 Bad Request Parametri non validi (intervalli di date, numeri EA e così via)
500 Errore del server Errore imprevisto nell'elaborazione della richiesta