Udostępnij za pośrednictwem


Migrowanie z interfejsu API szczegółów użycia wystąpień zarezerwowanych ea

Klienci z umową EA, którzy wcześniej używali interfejsu API raportowania przedsiębiorstwa consumption.azure.com w celu uzyskania szczegółów użycia wystąpienia zarezerwowanego, 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 szczegółów użycia wystąpienia zarezerwowanego

Firma Microsoft nie aktualizuje starszych synchronicznych interfejsów API szczegółów rezerwacji. W ramach migracji zalecamy przechodzenie do nowszego wzorca wywołań asynchronicznego interfejsu API obsługiwanego przez jednostkę usługi. Żądania asynchroniczne lepiej obsługują duże ilości danych i zmniejszają liczbę błędów przekroczenia limitu czasu.

Obsługiwane żądania

Podczas wywoływania nowego asynchronicznego interfejsu API szczegółów rezerwacji użyj następujących identyfikatorów URI żądania. Numer rejestracji powinien być używany jako identyfikator billingAccountId. Interfejs API można wywołać z następującym zakresem:

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

Generowanie raportu według identyfikatora konta rozliczeniowego

Przykładowe żądanie wygenerowania raportu szczegółów rezerwacji

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2023-11-01 

Żądanie POST zwraca lokalizację do sondowania stanu generowania raportu zgodnie z opisem w następującej odpowiedzi:

Przykładowa odpowiedź

Kod stanu 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2023-11-01
Retry-After: 60

Kod stanu 200

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Przykładowe żądanie dotyczące stanu generowania raportu sondowania

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/reservationDetailsOperationResults/{operationId}?api-version=2023-11-01 

Przykładowa odpowiedź na sondę

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Zmiany treści odpowiedzi

Poniższe informacje są przykładem odpowiedzi starszego synchronicznego interfejsu API szczegółów rezerwacji.

Stara odpowiedź:

{
    "reservationOrderId": "00000000-0000-0000-0000-000000000000",
    "reservationId": "00000000-0000-0000-0000-000000000000",
    "usageDate": "2018-02-01T00:00:00",
    "skuName": "Standard_F2s",
    "instanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resourvegroup1/providers/microsoft.compute/virtualmachines/VM1",
    "totalReservedQuantity": 18.000000000000000,
    "reservedHours": 432.000000000000000,
    "usedHours": 400.000000000000000
}

Nowa odpowiedź:

Nowy interfejs API tworzy plik CSV. Zobacz następujące pola pliku.

Stara właściwość Nowa właściwość Uwagi
InstanceFlexibilityGroup Nowa właściwość elastyczności rozmiaru wystąpienia.
InstanceFlexibilityRatio Nowa właściwość elastyczności rozmiaru wystąpienia.
instanceId InstanceName
Rodzaj Jest to nowa właściwość. Jej wartość to None, Reservation lub IncludedQuantity.
reservationId ReservationId
reservationOrderId ReservationOrderId
reservedHours ReservedHours
skuName SkuName
totalReservedQuantity TotalReservedQuantity
usageDate UsageDate
usedHours UsedHours