Omówienie migracji z usługi Azure Enterprise Reporting do interfejsów API usługi Microsoft Cost Management

Ten artykuł informuje deweloperów, którzy utworzyli niestandardowe rozwiązania przy użyciu interfejsów API raportowania przedsiębiorstwa platformy Azure o ważnych zmianach. Nowsze interfejsy API usługi Microsoft Cost Management oferują teraz ulepszone możliwości i obsługę jednostek usługi, dzięki czemu są one bardziej niezawodnym wyborem dla projektów.

Kluczowe punkty:

  • Zalecane migracji — zdecydowanie zalecamy przeprowadzenie migracji niestandardowych rozwiązań do interfejsów API usługi Microsoft Cost Management. Są one aktywnie opracowywane i oferują ulepszone funkcje.
  • Data wycofania — wszystkie interfejsy API raportowania przedsiębiorstwa platformy Azure są wycofane.

Ten artykuł zawiera następujące informacje:

  • Omówienie różnic między interfejsami API raportowania przedsiębiorstwa platformy Azure i interfejsami API usługi Cost Management.
  • Wskazówki dotyczące tego, czego można oczekiwać podczas migracji do interfejsów API usługi Cost Management.
  • Szczegółowe informacje na temat nowych funkcji dostępnych za pomocą interfejsów API usługi Cost Management.

Wywołanie akcji:

  • Aby zapewnić bezproblemowe przejście, zachęcamy do rozpoczęcia planowania migracji do interfejsów API usługi Cost Management przed datą wycofania.

Różnice między interfejsami API

Poniższe informacje opisują różnice między starszymi interfejsami API raportowania przedsiębiorstwa platformy Azure i nowszymi interfejsami API usługi Cost Management.

Używanie Interfejsy API raportowania dla przedsiębiorstw platformy Azure Interfejsy API usługi Microsoft Cost Management
Uwierzytelnianie Klucz interfejsu API aprowizowany w witrynie Azure Portal Uwierzytelnianie firmy Microsoft entra przy użyciu tokenów użytkownika lub jednostek usługi. Jednostki usługi mają miejsce kluczy interfejsu API.
Zakresy i uprawnienia Wszystkie żądania znajdują się w zakresie rejestracji. Przypisania uprawnień klucza interfejsu API określają, czy są zwracane dane dla całej rejestracji, działu, czy określonego konta. Brak uwierzytelniania użytkowników. Użytkownicy lub jednostki usługi mają przypisany dostęp do zakresu rejestracji, działu lub konta.
Punkt końcowy identyfikatora URI https://consumption.azure.com https://management.azure.com
Stan programowania Tryb konserwacji. Na ścieżce do wycofania. W aktywnym rozwoju
Dostępne interfejsy API Ograniczone do aktualnie dostępnych informacji Dostępne są równoważne interfejsy API, aby zastąpić każdy interfejs API umowy EA. Dostępne są również dodatkowe interfejsy API usługi Cost Management, w tym:
-Budżetów
-Alerty
-Wywozu

Lista kontrolna migracji

  • Zapoznaj się z Interfejsami API REST usługi Azure Resource Manager.
  • Ustal, których interfejsów API raportowania przedsiębiorstwa używasz, i zobacz, które interfejsy API usługi Cost Management mają przejść do sekcji Migrowanie z usługi Azure Enterprise Reporting do interfejsów API usługi Microsoft Cost Management.
  • Konfigurowanie autoryzacji i uwierzytelniania usługi dla interfejsów API usługi Cost Management. Aby uzyskać więcej informacji, zobacz Przypisywanie uprawnień do interfejsów API usługi ACM.
  • Przetestuj interfejsy API, a następnie zaktualizuj dowolny kod programowania, aby zastąpić wywołania interfejsu API raportowania przedsiębiorstwa wywołaniami interfejsu API usługi Cost Management.
  • Zaktualizuj obsługę błędów, wprowadzając nowe kody błędów. Oto niektóre zagadnienia:
    • Interfejsy API usługi Cost Management mają limit czasu 60 sekund.
    • Interfejsy API usługi Cost Management mają obowiązującą ograniczanie szybkości. Spowoduje to przekroczenie 429 throttling error stawek. Twórz rozwiązania, aby nie wykonywać zbyt wielu wywołań interfejsu API w krótkim czasie.
  • Zapoznaj się z innymi interfejsami API usługi Cost Management dostępnymi w usłudze Azure Resource Manager i oceń je pod kątem przyszłego użycia. Aby uzyskać więcej informacji, zobacz Migrowanie z usługi Azure Enterprise Reporting do interfejsów API usługi Microsoft Cost Management.

Mapowanie interfejsu API raportowania przedsiębiorstwa na nowe interfejsy API usługi Cost Management

Skorzystaj z poniższych informacji, aby zidentyfikować aktualnie używane interfejsy API raportowania przedsiębiorstwa i zastąpić interfejs API usługi Cost Management do użycia.

Scenariusz Interfejsy API raportowania przedsiębiorstwa Interfejsy API usługi Cost Management
Migrowanie z interfejsów API szczegółów użycia umowy EA /usagedetails/download
/usagedetails/submit
/usagedetails
/usagedetailsbycustomdate
Użyj opcji Microsoft.CostManagement/Export dla wszystkich cyklicznych obciążeń pozyskiwania danych.
Użyj raportu Szczegóły kosztów dla małych zestawów danych na żądanie.
Migrowanie z interfejsów API podsumowania salda umowy EA /balancesummary Microsoft.Consumption/balances
Migrowanie z interfejsów API arkusza cen umowy EA /pricesheet W przypadku wynegocjowanych cen użyj wartości Microsoft.Consumption/pricesheets/default
W przypadku cen detalicznych użyj interfejsu API cen detalicznych
Migrowanie z interfejsu API szczegółów użycia wystąpień zarezerwowanych ea /reservationdetails Microsoft.CostManagement/generateReservationDetailsReport
Migrowanie z interfejsów API podsumowania użycia wystąpień zarezerwowanych ea /reservationsummaries Microsoft.Consumption/reservationSummaries
Migrowanie z interfejsów API Rekomendacje wystąpienia zarezerwowanego ea /SharedReservationRecommendations
/SingleReservationRecommendations
Microsoft.Consumption/reservationRecommendations
Migrowanie z interfejsów API opłat za wystąpienia zarezerwowane ea /reservationcharges Microsoft.Consumption/reservationTransactions

Używanie dodatkowego interfejsu API usługi Cost Management

Po przeprowadzeniu migracji do interfejsów API usługi Cost Management dla istniejących scenariuszy raportowania możesz również użyć wielu innych interfejsów API. Interfejsy API są również dostępne za pośrednictwem usługi Azure Resource Manager i mogą być zautomatyzowane przy użyciu uwierzytelniania opartego na jednostce usługi. Poniżej przedstawiono krótkie podsumowanie nowych funkcji, których można użyć.

  • Budżety — służy do ustawiania progów umożliwiających aktywne monitorowanie kosztów, zgłaszanie alertów właściwym uczestnikom projektu i automatyzowanie akcji w odpowiedzi na naruszenia progów.
  • Alerty — służy do wyświetlania m.in. informacji o alertach, w tym alertów budżetu, alertów dotyczących faktur, alertów dotyczących środków i alertów dotyczących limitów przydziału.
  • Eksporty — służy do planowania cyklicznego eksportu danych dotyczących opłat na wybrane konto usługi Azure Storage. Jest to zalecane rozwiązanie dla klientów z dużą obecnością platformy Azure, którzy chcą analizować swoje dane i używać ich we własnych systemach wewnętrznych.