Rapportage-API's voor Enterprise-klanten - saldo en overzicht
Notitie
Op 1 mei 2024 worden Azure Enterprise Reporting-API's buiten gebruik gesteld. Alle resterende Enterprise Reporting-API's reageren niet meer op aanvragen. Klanten moeten voor die tijd overstappen op het gebruik van Microsoft Cost Management-API's. Zie Overzicht van Azure Enterprise Reporting naar Microsoft Cost Management API's migreren voor meer informatie.
De API voor saldo en overzicht biedt een maandelijks overzicht van de informatie over saldi, nieuwe aankopen, Azure Marketplace-servicekosten, correcties en overschrijdingskosten.
Aanvraag
Welke algemene headereigenschappen moeten worden toegevoegd, staat in het artikel Overzicht van rapportage-API's voor Enterprise-klanten. Als er geen factureringsperiode is opgegeven, worden de gegevens voor de huidige factureringsperiode geretourneerd.
| Methode | Aanvraag-URI |
|---|---|
| GET | https://consumption.azure.com/v3/enrollments/{enrollmentNumber}/balancesummary |
| GET | https://consumption.azure.com/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/balancesummary |
Notitie
Als u de vorige versie van de API wilt gebruiken, vervangt u v3 door v2 in de bovenstaande URL's. Sommige velden zijn niet beschikbaar als u v2 gebruikt.
Antwoord
{
"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
}
]
}
Definities van antwoordeigenschappen
| Eigenschapsnaam | Type | Beschrijving |
|---|---|---|
| id | tekenreeks | De unieke id voor een specifieke factureringsperiode en inschrijving |
| billingPeriodId | tekenreeks | De id van de factureringsperiode |
| currencyCode | tekenreeks | De valutacode |
| beginbalans | decimal | Het beginsaldo voor de factureringsperiode |
| endBalance | decimal | Het eindsaldo voor de factureringsperiode (voor openstaande perioden wordt dit dagelijks bijgewerkt) |
| newPurchases | decimal | Totaal nieuw aankoopbedrag |
| Aanpassingen | decimal | Totale aanpassingsbedrag |
| Gebruikt | decimal | Totaal toezeggingsgebruik |
| serviceOverage | decimal | Overschrijding voor Azure-services |
| chargesBilledSeparately | decimal | Afzonderlijk gefactureerde kosten |
| totalOverage | decimal | serviceOverage + kostenFactureerdSeparately |
| totalUsage | decimal | Azure-servicetoezegging + totale overschrijding |
| azureMarketplaceServiceCharges | decimal | Totale kosten voor Azure Marketplace |
| newPurchasesDetails | JSON-tekenreeksmatrix van naamwaardeparen | Lijst met nieuwe aankopen |
| adjustmentDetails | JSON-tekenreeksmatrix van naamwaardeparen | Lijst met aanpassingen (promotietegoed, SIE-tegoed, enzovoort) |