Delen via

Migreren van EA Balance Summary-API

  • Artikel

EA-klanten die voorheen de Enterprise Reporting consumption.azure.com-API gebruikten om hun saldooverzicht op te halen, moeten worden gemigreerd naar een vervangende Azure Resource Manager-API. De volgende instructies helpen u bij het migreren en bespreken van contractverschillen tussen de oude API en de nieuwe API.

Notitie

Alle Azure Enterprise Reporting-API's worden buiten gebruik gesteld. U moet zo snel mogelijk migreren naar Microsoft Cost Management-API's .

Machtigingen toewijzen aan een service-principal om de API aan te roepen

Voordat u de API aanroept, moet u een service-principal configureren met de juiste machtiging. U gebruikt de service-principal om de API aan te roepen. Zie Machtigingen toewijzen aan Cost Management-API's voor meer informatie.

De API saldooverzicht aanroepen

Gebruik de volgende aanvraag-URI's wanneer u de nieuwe API voor Saldo-overzicht aanroept. Uw inschrijvingsnummer moet worden gebruikt als billingAccountId.

Ondersteunde aanvragen

Ontvangen voor Inschrijving

https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/balances?api-version=2023-05-01

Wijzigingen in antwoordtekst

Oude antwoordtekst:

{
  "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
    }
  ]
}

Nieuwe antwoordtekst:

Dezelfde gegevens zijn nu beschikbaar in het eigenschappenveld van het nieuwe API-antwoord. Er kunnen kleine wijzigingen zijn in de spelling van sommige veldnamen.

{
  "id": "/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/balances/balanceId1",
  "name": "balanceId1",
  "type": "Microsoft.Consumption/balances",
  "properties": {
    "currency": "USD  ",
    "beginningBalance": 3396469.19,
    "endingBalance": 2922371.02,
    "newPurchases": 0,
    "adjustments": 0,
    "utilized": 474098.17,
    "serviceOverage": 0,
    "chargesBilledSeparately": 0,
    "totalOverage": 0,
    "totalUsage": 474098.17,
    "azureMarketplaceServiceCharges": 609.82,
    "billingFrequency": "Month",
    "priceHidden": false,
    "overageRefund": 2012.61,
    "newPurchasesDetails": [
      {
        "name": "Promo Purchase",
        "value": 1
      }
    ],
    "adjustmentDetails": [
      {
        "name": "Promo Credit",
        "value": 1.1
      },
      {
        "name": "SIE Credit",
        "value": 1
      }
    ]
  }
}

Gerelateerde inhoud