Udostępnij przez


Migrowanie z interfejsu API podsumowania użycia wystąpień zarezerwowanych EA

Klienci z umową EA, którzy wcześniej korzystali z interfejsu API consumption.azure.com Enterprise Reporting, aby uzyskać podsumowania użycia wystąpień zarezerwowanych, muszą przejść na równoważny interfejs API usługi Azure Resource Manager. Poniższe instrukcje ułatwiają migrację i omówienie wszelkich różnic kontraktów między starym interfejsem API a nowym interfejsem API.

Uwaga

Wszystkie interfejsy API do raportowania w usłudze Azure Enterprise zostały wycofane. Powinieneś jak najszybciej przeprowadzić migrację do interfejsów API usługi Microsoft Cost Management.

Przypisz uprawnienia jednostce usługi, aby wywołać interfejs API.

Przed wywołaniem interfejsu API należy skonfigurować podmiot usługi z odpowiednimi uprawnieniami. Jednostka usługi służy do wywoływania interfejsu API. Aby uzyskać więcej informacji, zobacz Przypisywanie uprawnień do interfejsów API Cost Management.

Wywoływanie interfejsu API podsumowania użycia wystąpienia zarezerwowanego

Użyj następujących URI żądań, aby wywołać nową API Podsumowań Rezerwacji.

Obsługiwane żądania

Wywołaj API z następującymi uprawnieniami:

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

Pobierz codzienne podsumowanie rezerwacji

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 

Pobieranie podsumowania rezerwacji co miesiąc

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 

Zmiany treści odpowiedzi

Stara odpowiedź:

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

Nowa odpowiedź:

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