Dela via


Migrera från API för sammanfattning av ea-reserverad instansanvändning

EA-kunder som tidigare använde Enterprise Reporting consumption.azure.com API för att hämta användningssammanfattningar för reserverade instanser måste migrera till ett Api för paritet i Azure Resource Manager. Följande instruktioner hjälper dig att migrera och diskutera eventuella kontraktsskillnader mellan det gamla API:et och det nya API:et.

Kommentar

Alla Azure Enterprise Reporting-API:er har dragits tillbaka. Du bör migrera till Microsoft Cost Management-API:er så snart som möjligt.

Tilldela behörigheter till ett huvudnamn för tjänsten för att anropa API:et

Innan du anropar API:et måste du konfigurera ett huvudnamn för tjänsten med rätt behörighet. Du använder tjänstens huvudnamn för att anropa API:et. Mer information finns i Tilldela behörigheter till Cost Management-API:er.

Anropa API:et för användningssammanfattning för reserverad instans

Använd följande begärande-URI:er för att anropa det nya API:et för reservationssammanfattningar.

Begäranden som stöds

Anropa API:et med följande omfång:

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

Hämta reservationssammanfattning dagligen

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 

Hämta reservationssammanfattning månatligen

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 

Ändringar i svarstext

Gammalt svar:

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

Nytt svar:

{
  "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
      }
    }
  ]
}
  • Läs översiktsartikeln Migrera från EA-rapportering till ARM-API:er.