API di creazione report per clienti Enterprise - Saldi e riepilogo
Nota
Il 1° maggio 2024 le API di creazione report di Azure Enterprise verranno ritirati. Tutte le API di creazione report aziendali rimanenti smetteranno di rispondere alle richieste. I clienti devono eseguire la transizione all'uso delle API di Gestione costi Microsoft prima di allora. Per altre informazioni, vedere Eseguire la migrazione da Azure Enterprise Reporting alle API di Gestione dei costi Microsoft.
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.
Richiesta
Le proprietà di intestazione comuni che devono essere aggiunte sono specificate nell'articolo Panoramica delle API di creazione report per clienti Enterprise. Se non viene specificato un periodo di fatturazione, vengono restituiti i dati per il periodo di fatturazione corrente.
| Metodo | URI richiesta |
|---|---|
| GET | https://consumption.azure.com/v3/enrollments/{enrollmentNumber}/balancesummary |
| GET | https://consumption.azure.com/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/balancesummary |
Nota
Per usare la versione precedente dell'API, sostituire v3 con v2 negli URL precedenti. Alcuni campi non sono disponibili se si usa v2.
Risposta
{
"id": "enrollments/100/billingperiods/201507/balancesummaries",
"billingPeriodId": 201507,
"currencyCode": "USD",
"beginningBalance": 0,
"endingBalance": 1.1,
"newPurchases": 1,
"adjustments": 1.1,
"utilized": 1.1,
"serviceOverage": 1,
"chargesBilledSeparately": 1,
"totalOverage": 1,
"totalUsage": 1.1,
"azureMarketplaceServiceCharges": 1,
"newPurchasesDetails": [
{
"name": "",
"value": 1
}
],
"adjustmentDetails": [
{
"name": "Promo Credit",
"value": 1.1
},
{
"name": "SIE Credit",
"value": 1.0
}
]
}
Definizioni delle proprietà di risposta
| Nome proprietà | Tipo | Descrizione |
|---|---|---|
| id | string | ID univoco per un periodo di fatturazione e per una registrazione specifici |
| billingPeriodId | string | ID periodo di fatturazione |
| currencyCode | string | Codice della valuta |
| beginningBalance | decimal | Saldo iniziale per il periodo di fatturazione |
| endingBalance | decimal | Saldo finale per il periodo di fatturazione (viene aggiornato quotidianamente per i periodi aperti) |
| newPurchases | decimal | Totale nuovo importo di acquisto |
| adjustments | decimal | Quantità totale rettificata |
| utilized | decimal | Uso totale dell'impegno |
| serviceOverage | decimal | Eccedenza per i servizi di Azure |
| chargesBilledSeparately | decimal | chargesBilledSeparately |
| totalOverage | decimal | serviceOverage + chargesBilledSeparately |
| totalUsage | decimal | Eccedenza totale + impegno servizio di Azure |
| azureMarketplaceServiceCharges | decimal | Spese totali per Azure Marketplace |
| newPurchasesDetails | Matrice di stringhe JSON di coppie nome-valore | Elenco di nuovi acquisti |
| adjustmentDetails | Matrice di stringhe JSON di coppie nome-valore | Elenco di modifiche (credito promo, credito SIE e così via) |