Migrieren von der Zusammenfassungs-API für die Nutzung reservierter EA-Instanzen

EA-Kunden, die zuvor die Enterprise Reporting consumption.azure.com-API zum Abrufen reservierter Instanzennutzungszusammenfassungen verwendet haben, müssen zu einer Paritäts-Azure Resource Manager-API migriert werden. Die folgenden Anweisungen helfen Ihnen beim Migrieren und Besprechen von Vertragsunterschieden zwischen der alten API 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.

Weisen Sie einem Dienstprinzipal Berechtigungen zum Aufrufen der API zu.

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.

Aufruf der Nutzung reservierter Instanzen Summary API

Verwenden Sie die folgenden Anforderungs-URIs, um die neue Reservierungszusammenfassungs-API aufzurufen.

Unterstützte Anforderungen

Rufen Sie die API mit den folgenden Berechtigungen auf:

  • Registrierung: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Reservierungszusammenfassung täglich abrufen

https://management.azure.com/{scope}/Microsoft.Consumption/reservationSummaries?grain=daily&$filter=properties/usageDate ge 2017-10-01 AND properties/usageDate le 2017-11-20&api-version=2023-05-01 

Reservierungszusammenfassung monatlich abrufen

https://management.azure.com/{scope}/Microsoft.Consumption/reservationSummaries?grain=daily&$filter=properties/usageDate ge 2017-10-01 AND properties/usageDate le 2017-11-20&api-version=2023-05-01 

Änderungen des Antwortinhalts

Alte Antwort:

[
     {
        "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "skuName": "Standard_F1s",
        "reservedHours": 24,
        "usageDate": "2018-05-01T00:00:00",
        "usedHours": 23,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 95.83,
        "maxUtilizationPercentage": 100
    }
]

Neue Antwort:

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.Consumption/reservationSummaries/reservationSummaries_Id1",
      "name": "reservationSummaries_Id1",
      "type": "Microsoft.Consumption/reservationSummaries",
      "tags": null,
      "properties": {
        "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "skuName": "Standard_B1s",
        "reservedHours": 720,
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0
      }
    }
  ]
}