Partager via


Vue d’ensemble de la migration des API Azure Enterprise Reporting vers les API Microsoft Cost Management

Cet article fournit des informations aux développeurs ayant créé des solutions personnalisées en utilisant des API Azure Enterprise Reporting sur d’importantes modifications. Les API Microsoft Cost Management plus récentes offrent désormais des fonctionnalités améliorées et une prise en charge des principaux de service, ce qui en fait un choix plus solide pour vos projets.

Points essentiels :

  • Migration recommandée : nous vous recommandons vivement d’envisager de migrer vos solutions personnalisées vers les API Microsoft Cost Management. Elles sont résolument développées et offrent des fonctionnalités améliorées.
  • Date de retrait – Toutes les API d’Azure Enterprise Reporting sont retirées.

Cet article fournit :

  • Une vue d’ensemble des différences entre les API Azure Enterprise Reporting et les API Cost Management.
  • Des conseils sur ce qu’il faut attendre lors de la migration vers les API Cost Management.
  • Des insights sur les nouvelles fonctionnalités disponibles avec les API Cost Management.

Appel à l’action :

  • Pour veiller à une transition fluide, nous vous encourageons à commencer à planifier votre migration vers les API Cost Management bien avant la date de mise hors service.

Différences entre les API

Les informations suivantes décrivent les différences existant entre les anciennes API Azure Enterprise Reporting et les API Cost Management plus récentes.

Utilisation API de création de rapports Azure Enterprise API Microsoft Cost Management
Authentification Clé API configurée dans le portail Azure Authentification Microsoft Entra au moyen de jetons utilisateur ou de principaux de service. Les principaux de service remplacent les clés API.
Étendues et autorisations Toutes les requêtes se trouvent dans l’étendue de l’inscription. Les attributions d’autorisations de clé d’API détermineront si les données de l’ensemble de l’inscription, d’un service ou d’un compte spécifique seront retournées. Aucune authentification utilisateur. Les utilisateurs ou les principaux du service se voient attribuer un accès à l’étendue de l’inscription, du service ou du compte.
Point de terminaison d’URI https://consumption.azure.com https://management.azure.com
État du développement Aucune, les API sont mises hors service. En cours de développement
API disponibles Limité à ce qui est actuellement disponible Des API équivalentes sont disponibles pour remplacer chaque API EA. D’autres API Cost Management sont également disponibles, notamment :
- les budgets
- les alertes
- les exportations

Liste des éléments à vérifier pour la migration

  • Familiarisez-vous avec les API REST Azure Resource Manager.
  • Déterminez quelles API Enterprise Reporting vous utilisez et identifiez les API Cost Management vers lesquelles migrer dans Migrer d’Azure Enterprise Reporting vers des API Microsoft Cost Management.
  • Configurer l’authentification et l’autorisation du service pour les API Cost Management. Pour plus d’informations, consultez Affecter des autorisations aux API ACM.
  • Testez les API, puis mettez à jour le code de programmation pour remplacer les appels d’API Enterprise Reporting par des appels d’API Cost Management.
  • Mettez à jour la gestion des erreurs pour utiliser de nouveaux codes d’erreur. Entre autres considérations à prendre en compte :
    • Les API Cost Management ont un délai d’expiration de 60 secondes.
    • Les API Cost Management ont une limitation du débit en place. Un 429 throttling error en découle en cas de dépassement. Générez vos solutions pour ne pas placer trop d’appels d’API sur une brève période.
  • Passez en revue les autres API de gestion des coûts disponibles par le biais d’Azure Resource Manager et évaluez-les pour une utilisation ultérieure. Pour plus d’informations, consultez Migrer d’Azure Enterprise Reporting vers des API Microsoft Cost Management.

Mappage d’API Enterprise Reporting aux nouvelles API Cost Management

Consultez les informations suivantes pour identifier les API Enterprise Reporting que vous utilisez actuellement et l’API Cost Management de remplacement à utiliser à la place.

Scénario API Enterprise Reporting API Cost Management
Migrer à partir des API Détails de l’utilisation EA /usagedetails/download
/usagedetails/submit
/usagedetails
/usagedetailsbycustomdate
Utilisez Microsoft.CostManagement/Exports pour toutes les charges de travail d’ingestion des données récurrentes.
Utilisez le rapport Détails des coûts pour les jeux de données à la demande de petite taille.
Migrer à partir d’API récapitulatives d’un solde EA /balancesummary Microsoft.Consumption/balances
Migrer à partir des API de grille tarifaire EA /pricesheet Pour les prix négociés, utilisez Microsoft.Consumption/pricesheets/default
Pour les prix de vent au détail, utilisez API des prix de vente au détail
Migrer depuis l’API Détails de l’utilisation des instances réservées EA /reservationdetails Microsoft.CostManagement/generateReservationDetailsReport
Migrer depuis les API Résumé de l’utilisation des instances réservées EA /reservationsummaries Microsoft.Consumption/reservationSummaries
Migrer à partir des API de suggestions relatives à l’instance réservée EA /SharedReservationRecommendations
/SingleReservationRecommendations
Microsoft.Consumption/reservationRecommendations
Migrer à partir des API de frais d’instance réservée EA /reservationcharges Microsoft.Consumption/reservationTransactions

Utiliser des API de gestion des coûts supplémentaires

Après la migration vers les API Cost Management pour vos scénarios de création de rapports existants, vous pouvez également utiliser de nombreuses autres API. Les API sont également disponibles par le biais d’Azure Resource Manager ; elles peuvent être automatisées à l’aide de l’authentification basée sur le principal de service. Voici un résumé rapide des nouvelles fonctionnalités que vous pouvez utiliser.

  • Budgets – À utiliser pour définir des seuils afin de, à un stade précoce, superviser vos coûts, alerter les parties prenantes concernées et automatiser les actions en réponse à des dépassements de seuil.
  • Alertes – À utiliser pour afficher des informations sur des alertes, notamment mais sans s’y limiter sur des alertes budgétaires, de facturation, de crédit et de quota.
  • Exportations – À utiliser pour planifier l’exportation périodique des données de vos frais vers un compte de stockage Azure de votre choix. C’est la solution recommandée pour les clients ayant une grande présence Azure, qui souhaitent analyser leurs données et les utiliser dans leurs propres systèmes internes.