Udostępnij przez


Migrate from Azure Enterprise Reporting to Microsoft Cost Management APIs overview

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. The newer Microsoft Cost Management APIs now offer enhanced capabilities and support for service principals, making them a more robust choice for your projects.

Kluczowe punkty:

  • Zalecamy migrację — 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 API raportowe przedsiębiorstwa Azure są wycofane.

Ten artykuł zawiera następujące informacje:

  • An overview of the differences between Azure Enterprise Reporting APIs and Cost Management APIs.
  • Wskazówki dotyczące tego, czego można oczekiwać podczas migracji do interfejsów API usługi Cost Management.
  • Wgląd w nowe możliwości dostępne dzięki API zarządzania kosztami.

Wywołanie akcji:

  • To ensure a smooth transition, we encourage you to begin planning your migration to the Cost Management APIs well in advance of the retirement date.

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żyj Azure Enterprise Reporting APIs Microsoft Cost Management APIs
Uwierzytelnianie API key provisioned in the Azure portal Microsoft Entra authentication using user tokens or service principals. Service principals take the place of API keys.
Zakresy i uprawnienia All requests are at the enrollment scope. Przypisania uprawnień klucza API określają, czy zwracane są dane dla całej rejestracji, działu czy określonego konta. Brak uwierzytelniania użytkowników. Users or service principals are assigned access to the enrollment, department, or account scope.
URI Endpoint https://consumption.azure.com https://management.azure.com
Stan rozwoju None, the APIs are retired. W fazie aktywnego rozwoju
Available APIs Ograniczone do aktualnie dostępnych informacji Equivalent APIs are available to replace each EA API. Dostępne są również dodatkowe interfejsy API zarządzania kosztami, w tym:
- Budżetów
- Alerts
- Eksport

Lista kontrolna migracji

  • Zapoznaj się z Interfejsami API REST usługi Azure Resource Manager.
  • pl-PL: Ustal, których API raportowania przedsiębiorstwa używasz, i sprawdź, do których API usługi Cost Management możesz przejść w sekcji Migrowanie z Azure Enterprise Reporting do Microsoft Cost Management APIs.
  • Configure service authorization and authentication for the Cost Management APIs. Aby uzyskać więcej informacji, zobacz Przypisywanie uprawnień do ACM API.
  • 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:
    • Cost Management APIs have a timeout period of 60 seconds.
    • Interfejsy API zarządzania kosztami mają wprowadzone ograniczenia szybkości. This results in a 429 throttling error if rates are exceeded. 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. For more information, see Migrate from Azure Enterprise Reporting to Microsoft Cost Management APIs.

Enterprise Reporting API mapping to new Cost Management APIs

Use the following information to identify the Enterprise Reporting APIs that you currently use and the replacement Cost Management API to use instead.

Scenariusz Enterprise Reporting APIs API zarządzania kosztami
Migrate from EA Usage Details APIs /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.
Migrate from EA Balance Summary APIs /balancesummary Microsoft.Consumption/balances
Migrate from EA Price Sheet APIs /pricesheet Dla wynegocjowanych cen użyj Microsoft.Consumption/pricesheets/default
W przypadku cen detalicznych użyj interfejsu API cen detalicznych
Migrate from EA Reserved Instance Usage Details API /reservationdetails Microsoft.CostManagement/generateReservationDetailsReport
Migrate from EA Reserved Instance Usage Summary APIs /reservationsummaries Microsoft.Consumption/reservationSummaries
Migrate from EA Reserved Instance Recommendations APIs /SharedReservationRecommendations
/RekomendacjeDlaPojedynczychRezerwacji
Microsoft.Consumption/reservationRecommendations
Migrate from EA Reserved Instance Charges APIs /reservationcharges Microsoft.Consumption/reservationTransactions

Use additional Cost Management APIs

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. The APIs are also available through Azure Resource Manager and can be automated using service principal-based authentication. 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.