Teilen über

Migrieren von EA Nutzung reservierter Instanzen Summary API

  • Artikel

EA-Kunden, die bisher die API "Enterprise Reporting consumption.azure.com" verwendet haben, um Zusammenfassungen über die Nutzung reservierter Instanzen zu erhalten, müssen auf eine gleichwertige Azure Resource Manager-API migrieren. 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.

Aufruf der Nutzung reservierter Instanzen Summary API

Verwenden Sie die folgenden Anforderungs-URIs, um die neue API für Reservierungszusammenfassungen aufzurufen.

Unterstützte Anforderungen

Rufen Sie die API mit den folgenden Bereichen auf:

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

Abrufen der Reservierungszusammenfassung: Täglich

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

Abrufen der Reservierungszusammenfassung: Monatlich

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 Antworttexts

Alter Antworttext:

[
     {
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "skuName": "Standard_F1s",
        "reservedHours": 24,
        "usageDate": "2018-05-01T00:00:00",
        "usedHours": 23,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 95.83,
        "maxUtilizationPercentage": 100
    }
]

Neuer Antworttext:

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

Zugehöriger Inhalt