Übersicht über die Migration von der Azure Enterprise-Berichterstellung zu Microsoft Cost Management-APIs

  • Artikel

Dieser Artikel informiert Entwickler, die mithilfe der Azure Enterprise Reporting-APIs benutzerdefinierte Lösungen erstellt haben, über wichtige Änderungen. Die neueren Microsoft Cost Management-APIs bieten jetzt erweiterte Funktionen und Support für Dienstprinzipale und machen sie zu einer robusteren Wahl für Ihre Projekte.

Die wichtigsten Punkte:

  • Migration empfohlen – Wir empfehlen Ihnen dringend, die Migration Ihrer benutzerdefinierten Lösungen auf die Microsoft Cost Management-APIs in Betracht zu ziehen. Sie werden aktiv entwickelt und bieten verbesserte Funktionen.
  • Einstellungsdatum – Die Azure Enterprise Reporting-APIs werden am 1. Mai 2024 eingestellt.

Dieser Artikel enthält Folgendes:

  • Eine Übersicht über die Unterschiede zwischen Azure Enterprise Reporting-APIs und Cost Management-APIs.
  • Einen Leitfaden zu den Erwartungen bei der Migration zu den Cost Management-APIs.
  • Einblicke in die neuen Funktionen, die mit den Cost Management-APIs verfügbar sind.

Handlungsaufforderung:

  • Um einen reibungslosen Übergang zu gewährleisten, empfehlen wir Ihnen, die Planung Ihrer Migration zu den Cost Management-APIs rechtzeitig vor dem Auslaufdatum zu beginnen.

API-Unterschiede

In den folgenden Informationen werden die Unterschiede zwischen den älteren Azure Enterprise-Berichterstellungs-APIs und den neueren Cost Management-APIs beschrieben.

Zweck Berichterstellungs-APIs für Azure Enterprise Microsoft Cost Management-APIs
Authentifizierung Im Azure-Portal bereitgestellter API-Schlüssel Microsoft Entra-Authentifizierung mit Benutzertoken oder Dienstprinzipalen. Dienstprinzipale werden anstelle von API-Schlüsseln verwendet.
Bereiche und Berechtigungen Alle Anforderungen sind im Registrierungsbereich enthalten. Anhand der Zuweisungen der API-Schlüsselberechtigungen wird ermittelt, ob Daten für die gesamte Registrierung, eine Abteilung oder ein bestimmtes Konto zurückgegeben werden. Keine Benutzerauthentifizierung. Für Benutzer oder Dienstprinzipale werden Berechtigungen für den Zugriff auf den Registrierungs-, Abteilungs- oder Kontobereich zugewiesen.
URI-Endpunkt https://consumption.azure.com https://management.azure.com
Entwicklungsstatus Im Wartungsmodus. Auf dem Weg zur Veraltung. In der aktiven Entwicklung
Verfügbare APIs Beschränkt auf die derzeit verfügbaren Elemente Es sind gleichwertige APIs als Ersatz für die einzelnen EA-APIs verfügbar. Es sind auch zusätzliche Cost Management-APIs verfügbar, z. B.:
– Budgets
– Warnungen
– Exporte

Migrationscheckliste

  • Machen Sie sich mit den Azure Resource Manager-REST-APIs vertraut.
  • Ermitteln Sie, welche Enterprise-Berichterstellungs-APIs Sie verwenden, und lesen Sie unter Migrieren von der Azure Enterprise-Berichterstellung zu Microsoft Cost Management-APIs, zu welchen Cost Management-APIs Sie wechseln sollten.
  • Konfigurieren Sie die Dienstautorisierung und -authentifizierung für die Cost Management-APIs. Weitere Informationen finden Sie unter Zuweisen von Berechtigungen zu ACM-APIs.
  • Testen Sie die APIs, und aktualisieren Sie dann jeden beliebigen Programmiercode so, dass er Aufrufe von Enterprise-Berichterstellungs-APIs durch Aufrufe von Cost Management-APIs ersetzt.
  • Aktualisieren Sie die Fehlerbehandlung für die Verwendung neuer Fehlercodes. Einige zu berücksichtigende Aspekte:
    • Cost Management-APIs haben ein Zeitlimit von 60 Sekunden.
    • Bei Cost Management-APIs gibt es eine Einschränkung der Rate. Dies führt zu 429 throttling error, wenn die Raten überschritten werden. Erstellen Sie Ihre Lösungen so, dass nicht zu viele API-Aufrufe in einem kurzen Zeitraum durchgeführt werden.
  • Sehen Sie sich die anderen Cost Management-APIs an, die unter Azure Resource Manager verfügbar sind, und bewerten Sie sie im Hinblick auf eine spätere Nutzung. Weitere Informationen finden Sie unter Migrieren von der Azure Enterprise-Berichterstellung zu Microsoft Cost Management-APIs.

Enterprise-Berichterstellungs-API-Zuordnung zu neuen Cost Management-APIs

Ermitteln Sie anhand der folgenden Informationen Ihre zurzeit verwendeten Enterprise-Berichterstellungs-APIs und die entsprechende Cost Management-API, die als Ersatz dienen soll.

Szenario Enterprise-Berichterstellungs-APIs Cost Management-APIs
Migrieren von den EA-Nutzungsdetails-APIs /usagedetails/download
/usagedetails/submit
/usagedetails
/usagedetailsbycustomdate		 Verwenden Sie Microsoft.CostManagement/Exports für alle wiederkehrenden Workloads zur Datenerfassung.
Verwenden Sie den Bericht Kostendetails für kleine On-Demand-Datasets.
Migrieren von den EA-Saldozusammenfassungs-APIs /balancesummary Microsoft.Consumption/balances
Migrieren von den EA-Preisblatt-APIs /pricesheet Die vereinbarten Preise finden Sie unter Microsoft.Consumption/pricesheets/default.
Informationen zu Einzelhandelspreisen finden Sie unter API für Einzelhandelspreise.
Migrieren von der EA-API für Nutzungsdetails zu reservierten Instanzen /reservationdetails Microsoft.CostManagement/generateReservationDetailsReport
Migrieren von den EA-APIs für die Nutzungszusammenfassung für reservierte Instanzen /reservationsummaries Microsoft.Consumption/reservationSummaries
Migrieren von den EA-APIs für Empfehlungen für reservierte Instanzen /SharedReservationRecommendations
/SingleReservationRecommendations		 Microsoft.Consumption/reservationRecommendations
Migrieren von der Gebühren-API für reservierte EA-Instanzen /reservationcharges Microsoft.Consumption/reservationTransactions

Verwenden zusätzlicher Cost Management-APIs

Nachdem Sie die Migration zu den Cost Management-APIs für Ihre vorhandenen Berichterstellungsszenarien abgeschlossen haben, können Sie noch viele weitere APIs nutzen. Die APIs sind auch über Azure Resource Manager verfügbar und können per Authentifizierung auf Dienstprinzipalbasis automatisiert werden. Hier ist eine kurze Zusammenfassung der neuen Funktionen angegeben, die Sie nutzen können.

  • Budgets: Verwenden Sie diese Funktion zum Festlegen von Schwellenwerten, um Ihre Kosten proaktiv zu überwachen, die relevanten Projektbeteiligten zu benachrichtigen und automatisierte Aktionen als Reaktion auf Überschreitungen der Schwellenwerte festzulegen.
  • Warnungen: Verwenden Sie diese Funktion zum Anzeigen von Warnungsinformationen, z. B. für die Bereiche Budget, Rechnungen, Guthaben, Kontingente und mehr.
  • Exporte: Verwenden Sie diese Funktion zum Planen des wiederkehrenden Exports Ihrer Gebührendaten in ein Azure Storage-Konto Ihrer Wahl. Dies ist die empfohlene Lösung für Kunden mit einer großen Azure-Präsenz, die ihre Daten analysieren und in eigenen internen Systemen verwenden möchten.

Nächste Schritte