Udostępnij za pośrednictwem


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 raportowania przedsiębiorstwa w celu uzyskania podsumowań użycia wystąpień zarezerwowanych, muszą przeprowadzić migrację do interfejsu API usługi Azure Resource Manager z parzystością. 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 raportowania przedsiębiorstwa platformy Azure są wycofane. Jak najszybciej należy przeprowadzić migrację do interfejsów API usługi Microsoft Cost Management.

Przypisywanie uprawnień do jednostki usługi w celu wywołania interfejsu API

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

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

Użyj następujących identyfikatorów URI żądania, aby wywołać nowy interfejs API podsumowań rezerwacji.

Obsługiwane żądania

Wywołaj interfejs API z następującymi zakresami:

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

Pobierz podsumowanie rezerwacji codziennie

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 

Pobierz podsumowanie rezerwacji miesięcznie

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

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