Rapporterings-API:er för Enterprise-kunder – Saldo och sammanfattning
Anteckning
Den 1 maj 2024 dras Azure Enterprise Reporting API:er tillbaka. Eventuella återstående API:er för Enterprise Reporting slutar svara på begäranden. Kunderna måste gå över till att använda Api:er för Microsoft Cost Management innan dess. Mer information finns i Översikt över att migrera från Azure Enterprise Reporting till Microsoft Cost Management-API:er.
API:et för saldo och sammanfattning tillhandahåller en månatlig sammanfattning av saldon, nya inköp, Azure Marketplace-tjänstavgifter, justeringar och överförbrukningsavgifter.
Förfrågan
I artikeln Översikt över rapporterings-API:er för Enterprise-kunder anges Vanliga rubrikegenskaper som måste läggas till. Om ingen faktureringsperiod anges returneras data för den aktuella faktureringsperioden.
| Metod | URI för förfrågan |
|---|---|
| GET | https://consumption.azure.com/v3/enrollments/{enrollmentNumber}/balancesummary |
| GET | https://consumption.azure.com/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/balancesummary |
Anteckning
Om du vill använda den tidigare versionen av API:et ersätter du v3 med v2 i URL:erna ovan. Vissa fält är inte tillgängliga om du använder v2.
Svarsåtgärder
{
"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
}
]
}
Egenskapsdefinitioner för svar
| Egenskapens namn | Typ | Description |
|---|---|---|
| id | sträng | Unikt ID för en viss faktureringsperiod och registrering |
| billingPeriodId | sträng | Faktureringsperiod-ID |
| currencyCode | sträng | Valutakoden |
| beginningBalance | decimal | Startsaldot för faktureringsperioden |
| endingBalance | decimal | Slutsaldot för faktureringsperioden (för öppna perioder uppdateras det dagligen) |
| newPurchases | decimal | Totalt nytt inköpsbelopp |
| Justeringar | decimal | Totalt justeringsbelopp |
| Utnyttjas | decimal | Total användning av åtagande |
| serviceOverage | decimal | Överförbrukning för Azure-tjänster |
| chargesBilledSeparately | decimal | Avgifter som debiteras separat |
| totalOverage | decimal | serviceOverage + chargesBilledSeparately |
| totalUsage | decimal | Azure-tjänståtagande + total överförbrukning |
| azureMarketplaceServiceCharges | decimal | Totala avgifter för Azure Marketplace |
| newPurchasesDetails | JSON-strängmatris med namnvärdepar | Lista över nya inköp |
| adjustmentDetails | JSON-strängmatris med namnvärdepar | Lista över justeringar (kampanjkredit, SIE-kredit osv.) |