Freigeben über

Migrieren von der EA-Saldozusammenfassungs-API

  • Artikel

EA-Kunden, die bisher die API für Unternehmensberichte von consumption.azure.com verwendet haben, um ihre Saldozusammenfassungs abzurufen, müssen auf eine gleichwertige Azure Resource Manager-API umsteigen. Die folgenden Anweisungen helfen Ihnen bei der Migration und erläutern alle Vertragsunterschiede zwischen der alten und der neuen API.

Hinweis

Alle Azure Enterprise-Berichterstellungs-APIs werden eingestellt. Sie sollten so bald wie möglich zu Microsoft Cost Management-APIs migrieren.

Zuweisen von Berechtigungen zu einem Dienstprinzipal zum Aufrufen der API

Bevor Sie die API aufrufen, müssen Sie einen Dienstprinzipal mit der richtigen Berechtigung konfigurieren. Sie verwenden den Dienstprinzipal, um die API aufzurufen. Weitere Informationen finden Sie unter Zuweisen von Berechtigungen zu Cost Management-APIs.

Aufrufen der Saldozusammenfassungs-API

Verwenden Sie die folgenden Anforderungs-URIs beim Aufrufen der neuen Saldozusammenfassungs-API. Ihre Registrierungsnummer sollte als billingAccountId verwendet werden.

Unterstützte Anforderungen

Abrufen für Registrierung

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

Änderungen des Antworttexts

Alter Antworttext:

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

Neuer Antworttext:

Die gleichen Daten sind jetzt im Feld „properties“ der neuen API-Antwort verfügbar. Unter Umständen weisen einige Feldnamen eine etwas andere Schreibweise auf.

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

Zugehöriger Inhalt