Panoramica delle API di creazione di report per i clienti EnterpriseOverview of Reporting APIs for Enterprise customers

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.The Reporting APIs enable Enterprise Azure customers to programmatically pull consumption and billing data into preferred data analysis tools.

Abilitazione dell'API per l'accesso ai datiEnabling data access to the API

  • 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.Generate or retrieve the API key - Log in to the Enterprise portal and follow the tutorial under Help - Reporting APIs. La prima sezione in tale articolo illustra come generare o recuperare la chiave API per la registrazione specificata.The first section under this help article explains how to generate or retrieve the API key for the specified enrollment.
  • Passare le chiavi nell'API - La chiave API deve essere passata per ogni chiamata per l'autenticazione e l'autorizzazione.Passing keys in the API - The API key needs to be passed for each call for Authentication and Authorization. La proprietà seguente deve essere passata alle intestazioni HTTP:The following property needs to be to the HTTP headers
Chiave intestazione necessariaRequest Header Key ValoreValue
AuthorizationAuthorization Specificare il valore nel formato: bearer {API_KEY}Specify the value in this format: bearer {API_KEY}
Esempio: bearer eyr....09Example: bearer eyr....09

API per l'usoConsumption APIs

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.A Swagger endpoint is available here for the APIs described below which should enable easy introspection of the API and the ability to generate client SDKs using AutoRest or Swagger CodeGen. I dati a partire dal 1° maggio 2014 sono disponibili tramite questa API.Data beginning May 1, 2014 is available through this 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.Balance and Summary - The Balance and Summary API offers a monthly summary of information on balances, new purchases, Azure Marketplace service charges, adjustments and overage charges.

  • 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.Usage Details - The Usage Detail API offers a daily breakdown of consumed quantities and estimated charges by an Enrollment. Il risultato include anche informazioni su istanze, contatori e reparti.The result also includes information on instances, meters and departments. 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.The API can be queried by Billing period or by a specified start and end date.

  • 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).Marketplace Store Charge - The Marketplace Store Charge API returns the usage-based marketplace charges breakdown by day for the specified Billing Period or start and end dates (one time fees are not included).

  • Elenco prezzi - L'API elenco prezzi offre la tariffa applicabile per ogni contatore per la registrazione e il periodo di fatturazione specificati.Price Sheet - The Price Sheet API provides the applicable rate for each Meter for the given Enrollment and Billing Period.

API di supportoHelper APIs

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.List Billing Periods - The Billing Periods API returns a list of billing periods that have consumption data for the specified Enrollment in reverse chronological order. Ogni periodo contiene una proprietà che punta alla route API per i quattro set di dati, ovvero BalanceSummary, UsageDetails, MarketplaceCharges e PriceSheet.Each Period contains a property pointing to the API route for the four sets of data - BalanceSummary, UsageDetails, Marketplace Charges, and Price Sheet.

Codici di risposta dell'APIAPI Response Codes

Codice di stato della rispostaResponse Status Code MessageMessage DescrizioneDescription
200200 OKOK Nessun erroreNo error
401401 Non autorizzataUnauthorized Chiave API non trovata, non valida, scaduta e così viaAPI Key not found, Invalid, Expired etc.
404404 Non disponibileUnavailable Endpoint del report non trovatoReport endpoint not found
400400 Bad RequestBad Request Parametri non validi (intervalli di date, numeri EA e così via)Invalid params – Date ranges, EA numbers etc.
500500 Errore del serverServer Error Errore imprevisto nell'elaborazione della richiestaUnexoected error processing request