Overzicht van Migratie van Azure Enterprise Reporting naar Microsoft Cost Management-API's

  • Artikel

In dit artikel worden ontwikkelaars geïnformeerd die aangepaste oplossingen hebben gebouwd met behulp van de Rapportage-API's van Azure Enterprise over belangrijke wijzigingen. De nieuwere Microsoft Cost Management-API's bieden nu verbeterde mogelijkheden en ondersteuning voor service-principals, waardoor ze een krachtigere keuze zijn voor uw projecten.

Belangrijkste punten:

  • Migratie wordt aanbevolen. We raden u ten zeerste aan om uw aangepaste oplossingen te migreren naar de Microsoft Cost Management-API's. Ze worden actief ontwikkeld en bieden verbeterde functionaliteit.
  • Buitengebruikstellingsdatum: alle Azure Enterprise Reporting-API's worden buiten gebruik gesteld.

Dit artikel bevat:

Aanroep naar actie:

  • Om een soepele overgang te garanderen, raden we u aan om te beginnen met het plannen van uw migratie naar de Cost Management-API's vóór de buitengebruikstellingsdatum.

API-verschillen

In de volgende informatie worden de verschillen beschreven tussen de oudere Azure Enterprise Reporting-API's en de nieuwere Cost Management-API's.

Gebruik Rapportage-API's voor Azure Enterprise Microsoft Cost Management-API's
Verificatie API-sleutel ingericht in Azure Portal Microsoft Entra-verificatie met behulp van gebruikerstokens of service-principals. Service-principals vinden plaats van API-sleutels.
Bereiken en machtigingen Alle aanvragen bevinden zich binnen het inschrijvingsbereik. Api-sleutelmachtigingen bepalen of gegevens voor de volledige inschrijving, een afdeling of een specifiek account worden geretourneerd. Geen gebruikersverificatie. Gebruikers of service-principals krijgen toegang tot het bereik van de inschrijving, afdeling of account.
URI-eindpunt https://consumption.azure.com https://management.azure.com
Ontwikkelingsstatus In onderhoudsmodus. Wordt binnenkort afgeschaft. In actieve ontwikkeling
Beschikbare API's Beperkt tot wat momenteel beschikbaar is Er zijn equivalente API's beschikbaar om elke EA API te vervangen. Er zijn ook extra Cost Management-API's beschikbaar, waaronder:
-Begrotingen
-Waarschuwingen
-Export

Migratiecontrolelijst

  • Maak u vertrouwd met de Azure Resource Manager REST API's.
  • Bepaal naar welke Enterprise Reporting-API's u gebruikt en kijk naar welke Cost Management-API's u wilt overstappen bij Migrate van Azure Enterprise Reporting naar Microsoft Cost Management-API's.
  • Configureer serviceautorisatie en verificatie voor de Cost Management-API's. Zie Machtiging toewijzen aan ACM-API's voor meer informatie.
  • Test de API's en werk vervolgens elke programmeercode bij om Enterprise Reporting API-aanroepen te vervangen door Cost Management-API-aanroepen.
  • Foutafhandeling bijwerken om nieuwe foutcodes te gebruiken. Enkele overwegingen zijn:
    • Cost Management-API's hebben een time-outperiode van 60 seconden.
    • Cost Management-API's hebben snelheidsbeperking. Dit resulteert in een 429 throttling error if-snelheid die wordt overschreden. Bouw uw oplossingen zodat u niet te veel API-aanroepen maakt in een korte periode.
  • Bekijk de andere Cost Management API's die beschikbaar zijn via Azure Resource Manager, en beoordeel ze voor later gebruik. Zie Migreren van Azure Enterprise Reporting naar Microsoft Cost Management-API's voor meer informatie.

Api-toewijzing van Enterprise Reporting aan nieuwe Cost Management-API's

Gebruik de volgende informatie om de Enterprise Reporting-API's te identificeren die u momenteel gebruikt en de vervangende Cost Management-API die u in plaats daarvan kunt gebruiken.

Scenario Enterprise Reporting-API's Kostenbeheer-API's
Migreren van API's voor EA-gebruiksgegevens /usagedetails/download
/usagedetails/submit
/usagedetails
/usagedetailsbycustomdate		 Gebruik Microsoft.CostManagement/Exports voor alle terugkerende werkbelastingen voor gegevensopname.
Gebruik het rapport Kostendetails voor kleine gegevenssets op aanvraag.
Migreren van EA Balance Summary-API's /balancesummary Microsoft.Consumption/balances
Migreren van API's voor EA-prijzenoverzichten /pricesheet Voor overeengekomen prijzen gebruikt u Microsoft.Consumption/pricesheets/default
Voor retailprijzen gebruikt u DE API voor retailprijzen
Migreren vanuit de API voor gebruiksgegevens van gereserveerde EA-instanties /reservationdetails Microsoft.CostManagement/generateReservationDetailsReport
Migreren van API's voor het gebruik van gereserveerde instanties van EA /reservationsummaries Microsoft.Consumption/reservationSummaries
Migreren van gereserveerde EA-instantie Aanbevelingen API's /SharedReservationRecommendations
/SingleReservationRecommendations		 Microsoft.Consumption/reservationRecommendations
Migreren van API's voor kosten voor gereserveerde EA-instanties /reservationcharges Microsoft.Consumption/reservationTransactions

Aanvullende Cost Management API's gebruiken

Nadat u bent gemigreerd naar de Cost Management-API's voor uw bestaande rapportagescenario's, kunt u ook veel andere API's gebruiken. De API's zijn ook beschikbaar via Azure Resource Manager en kunnen worden geautomatiseerd met behulp van verificatie op basis van een service-principal. Hier volgt een kort overzicht van de nieuwe mogelijkheden die u kunt gebruiken.

  • Budgetten: om drempelwaarden in te stellen om uw kosten proactief te bewaken, relevante belanghebbenden te waarschuwen, en acties te automatiseren als reactie op schendingen van de drempelwaarden.
  • Waarschuwingen: om waarschuwingsgegevens te bekijken, inclusief, maar niet beperkt tot, waarschuwingen voor budgetten, facturen, tegoeden en quota.
  • Exports: om terugkerende gegevensexports van uw kosten te plannen naar een Azure Storage-account van uw keuze. Dit is de aanbevolen oplossing voor klanten met een grote Azure-aanwezigheid die hun gegevens wil analyseren en gebruiken in hun eigen interne systemen.

Gerelateerde inhoud