Consumo Azure

  • Articolo

Le API per il consumo di Azure consentono l'accesso a livello di codice ai dati sui costi e sull'utilizzo per le risorse di Azure. Le API supportano attualmente solo le registrazioni Enterprise, le sottoscrizioni Web Direct (con alcune eccezioni) e le sottoscrizioni del piano di Azure CSP. Le API vengono continuamente aggiornate per supportare altri tipi di sottoscrizioni di Azure.

Le API per il consumo di Azure consentono l'accesso a:

  • Solo clienti Enterprise
    • Elenco prezzi
    • Budget
    • Previsioni
    • Saldi
    • Tag
    • Tag dei costi
  • Clienti Enterprise e Accesso Web diretto
    • Dettagli di prenotazione
    • Riepiloghi di prenotazioni
    • Addebiti per Marketplace
    • Dettagli sull'utilizzo
    • Raccomandazioni di prenotazione

Elenco dei tipi di sottoscrizione non supportati

  • MS-AZR-0145P (CSP)
  • MS-AZR-0146P (CSP)
  • MS-AZR-159P (CSP)
  • MS-AZR-0036P (sponsorizzata)
  • MS-AZR-0143P (sponsorizzata)
  • MS-AZR-0015P (interna)
  • MS-AZR-0144P (DreamSpark)

Utilizzo dei periodi di fatturazione e degli intervalli di date

I dettagli di utilizzo e gli addebiti del Marketplace accettano periodi di fatturazione o intervalli di date per definire le date di inizio e fine per i dati di utilizzo.

Ecco il comportamento dell'API in base ai periodi di fatturazione e agli intervalli di date nella richiesta.

Periodo di fatturazione presente nella richiesta Data di inizio presente nella richiesta Data di fine presente nella richiesta Comportamento dell'API
no no no I dati per il periodo di fatturazione corrente vengono restituiti in risposta
no sì no I dati per il periodo di fatturazione corrente vengono restituiti in risposta
no no sì I dati per il periodo di fatturazione corrente vengono restituiti in risposta
no sì sì I dati per la data di inizio e di fine specificati vengono restituiti in risposta
sì no no I dati per il periodo di fatturazione specificato vengono restituiti in risposta
sì sì no I dati per il periodo di fatturazione specificato vengono restituiti in risposta
sì no sì I dati per il periodo di fatturazione specificato vengono restituiti in risposta
sì Sì Sì I dati per la data di inizio e di fine specificati vengono restituiti in risposta, il periodo di fatturazione specificato viene ignorato

L'intervallo massimo di date consentito è di 12 mesi in una richiesta e i dati sono disponibili dal 1° maggio 2014 o versione successiva.

Ottenere l'elenco dei periodi di fatturazione

Per fornire un periodo di fatturazione valido nella richiesta, il client deve prima ottenere un elenco dei periodi di fatturazione disponibili per sottoscrizione, usando l'API seguente

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods?api-version=2017-04-24-preview

Usando questo elenco, il client può scegliere un periodo di fatturazione specifico per ottenere i dati sull'utilizzo.

Dati in arrivo in ritardo

Per gestire i servizi di terze parti, che presentano ritardi nell'utilizzo dei report, la data di utilizzo segnalata viene impostata sull'ora in cui sono stati inviati i dati di utilizzo, anziché quando si è verificato l'utilizzo effettivo, ovvero il tempo di utilizzo.

Di conseguenza, l'utilizzo verrà valutato per e applicato all'ora segnalata. Per rappresentare il tempo di utilizzo effettivo, le proprietà. Il campo AdditionalProperties conterrà ora due proprietà aggiuntive. ConsumptionBeginTime e ConsumptionEndTime sono i nuovi campi che corrispondono all'intervallo di tempo di utilizzo effettivo.

Queste modifiche comportano alcuni scenari che dovranno essere risolti quando si chiama l'API dei dettagli di utilizzo:

  1. Report fine mese: per l'utilizzo che si è verificato durante un mese, ma segnalato durante il mese successivo, i clienti dovranno esaminare il campo additionalProperties per assegnare l'utilizzo al mese appropriato.

  2. Dettagli utilizzo query: quando si esegue una query sull'API dei dettagli di utilizzo per un intervallo di date, la query si applica solo alla data del report di utilizzo e non al tempo di utilizzo nel campo additionalProperties . Per i clienti che cercano di eseguire il mapping dei dettagli di utilizzo alle fatture, questo aggiornamento non influisce sul processo perché la fattura elabora l'utilizzo in base alla data del report sull'utilizzo. Per i clienti, cercando di mappare i dettagli di utilizzo a una data/mese di calendario specifico, questo aggiornamento è una modifica che causa un'interruzione e per questi scenari non è possibile usare la data del report sull'utilizzo e la data in cui si è verificato l'utilizzo, nella sezione additionalProperties deve essere usata.

Chiamata di esempio per altri dettagli:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/usageDetails?api-version=2018-03-31&$expand=properties/additionalProperties

Frammento di risposta di esempio:

  "properties": {
    "billingPeriodId":"/subscriptions/{subscriptionid}/providers/Microsoft.Billing/billingPeriods/20180501",
    "usageStart":"2018-05-01T00:00:00.0000000Z",
    "usageEnd":"2018-05-01T23:59:59.0000000Z",
    "instanceId":"/subscriptions/{subscriptionid}/resourceGroups/{resourcegroup}/providers/Microsoft.Cdn/profiles/{profile}",
    "instanceName":"{id}",
    "instanceLocation":"SouthCentralUS",
    "meterId":"6b88ada0-cbc0-4874-be0e-23004f8b4de7",
    "usageQuantity":0.002065,
    "pretaxCost":0,
    "currency":"USD",
    "additionalProperties": {
      "Provider": "1",
      "ConsumptionBeginTime": "2018-05-01T19:00:00",
      "ConsumptionEndTime": "2018-05-01T20:00:00"
    }
  }

Vedi anche

Per altre informazioni sull'uso di questa API in uno degli SDK specifici della lingua, vedere gli argomenti seguenti

SDK di Python sul consumo di Azure

Interfaccia della riga di comando per il consumo di Azure

SDK di Node.js sul consumo di Azure

SDK di Ruby sul consumo di Azure