Delen via

Migreren van DE API voor gebruik van gereserveerde instanties van EA

  • Artikel

EA-klanten die eerder de Enterprise Reporting consumption.azure.com-API gebruikten om samenvattingen van het gebruik van gereserveerde instanties te verkrijgen, moeten worden gemigreerd naar een Azure Resource Manager-API voor pariteit. 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 voor het gebruik van gereserveerde instanties aanroepen

Gebruik de volgende aanvraag-URI's voor het aanroepen van de nieuwe API voor Reserveringsoverzichten.

Ondersteunde aanvragen

Roep de API aan met behulp van de volgende bereiken:

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

Dagelijks een reserveringsoverzicht ontvangen

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

Maandelijks een reserveringsoverzicht ontvangen

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

Wijzigingen in antwoordtekst

Oud antwoord:

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

Nieuw antwoord:

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

Gerelateerde inhoud