Migrer depuis des API Enterprise Agreement vers des API Microsoft Customer Agreement

Cet article vous aide à comprendre la structure de données, l’API et les autres différences d’intégration de système entre les comptes de Contrat Entreprise Microsoft (ou EA pour Enterprise Agreement) et de Contrat Client Microsoft (ou MCA, pour Microsoft Customer Agreement). Cost Management prend en charge les API des deux types de compte. Avant de continuer, veuillez lire l’article Découvrez comment configurer votre compte de facturation associé à un Contrat Client Microsoft.

Nous recommandons aux organisations ayant déjà un compte EA de lire attentivement cet article lorsqu’ils configurent leur compte MCA. Auparavant, le renouvellement d’un compte EA nécessitait un minimum de travail pour passer d’une ancienne inscription vers une nouvelle. Quant à la migration vers un compte MCA, elle nécessitait des efforts supplémentaires. Ces efforts supplémentaires étaient dus aux modifications du sous-système de facturation sous-jacent, impactant toutes les API liées et les offres de service liés aux coûts.

API et intégration MCA

La nouvelle intégration et les API MCA vous permettent de :

• Disposer d’une disponibilité complète via des API Azure natives.
• Configurer plusieurs factures dans un seul compte de facturation.
• Pouvoir accéder à une API combinée avec l’utilisation des services Azure, ainsi qu’avec l’utilisation et les achats d’une place de marché tierce.
• Voir les coûts des différents profils de facturation (tout comme pour les inscriptions) à l’aide de Cost Management.
• Pouvoir accéder aux nouvelles API pour afficher les coûts, être averti lorsque les coûts dépassent des seuils prédéfinis, et exporter des données brutes automatiquement.

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

Les éléments suivants vous aideront à d’effectuer votre transition vers les API MCA.

• Familiarisez-vous avec le contenu de l’article Prise en main de votre compte de facturation dans le cadre d’un Contrat Client Microsoft.
• Déterminez les API que vous utilisez et affichez celles qui sont remplacées dans la section suivante.
• Familiarisez-vous avec les API REST Azure Resource Manager.
• Si vous n’utilisez pas déjà des API Azure Resource Manager, inscrivez votre application cliente auprès de Microsoft Entra ID.
• Accordez à l’application qui a été créée pendant l’inscription d’application Microsoft Entra un accès en lecture au compte de facturation à l’aide du contrôle d’accès (IAM).
• Mettez à jour le code de programmation pour utiliser l’authentification Microsoft Entra.
• Mettez à jour le code de programmation pour remplacer les appels d’API EA par les appels d’API MCA.
• Mettez à jour la gestion des erreurs pour utiliser de nouveaux codes d’erreur.
• Passez en revue les autres offres d’intégrations, telles que Power BI, pour d’autres actions requises.

API EA remplacées par les API MCA

Les API EA utilisent une clé d’API pour l’authentification et l’autorisation. Les API MCA utilisent l’authentification Microsoft Entra.

¹ Le service Azure et l’utilisation de la Place de marché par des tiers sont disponibles avec l’API Détails d’utilisation.

Les API suivantes sont disponibles pour les comptes de facturation MCA :

² Les APIs renvoient des listes d’objets, qui sont des étendues, où fonctionnent les expériences Cost Management dans le Portail Azure, ainsi que les API. Pour plus d’informations sur les étendues Cost Management, consultez Comprendre et utiliser les étendues.

Si vous utilisez déjà des API EA, vous devez les mettre à jour pour prendre en charge les comptes de facturation MCA. Le tableau suivant présente les autres modifications de l’intégration :

API pour obtenir le solde et crédits

L’option Obtenir un résumé du solde a été utilisée pour vous donner un résumé mensuel de :

• Balances
• Nouveaux achats
• Frais du service Place de marché Azure
• Ajustements
• Frais de dépassement de service

Toutes les API de consommation sont remplacées par des API Azure natives qui utilisent Microsoft Entra ID pour l’authentification et l’autorisation. Pour plus d’informations sur l’appel des API REST Azure, consultez Prise en main de REST.

L’API Get Balance Summary est remplacée par l’API Available Balance (Solde disponible) (Microsoft.Billing/billingAccounts/billingProfiles/availableBalance).

Pour obtenir les soldes disponibles avec l’API Available Balance :

API pour obtenir le coût et utilisation

Permet d’obtenir une décomposition quotidienne des coûts à partir de l’utilisation des services Azure, de l’utilisation de la Place de marché par des tiers et d’autres achats de la Place de marché avec les API suivantes. Les API suivantes ont été fusionnées pour les services Azure et l’utilisation de la Place de marché par des tiers. Les anciennes API sont remplacées par Exports ou par l’API Cost Details. Pour choisir la solution qui vous convient, consultez Choisir une solution de détails des coûts. Les deux solutions fournissent le même fichier de détails des coûts et comprennent dans leurs données des achats sur le marketplace, qui étaient précédemment affichés uniquement dans le résumé du solde.

Exports et l’API Cost Details, comme avec toutes les API Cost Management, sont disponibles pour plusieurs étendues. Pour les coûts facturés, utilisez l’étendue du profil de facturation, comme vous le feriez normalement pour un niveau d’accord de mise en œuvre. Pour plus d’informations sur les étendues Cost Management, consultez Comprendre et utiliser les étendues.

Certains noms de propriétés ont changé dans le nouveau jeu de données Cost Details disponible via Exports et l’API Cost Details. Le tableau suivant présente les propriétés correspondantes.

Remplacement de l’API Billing Periods par l’API Invoices

Les comptes de facturation MCA n’utilisent pas de périodes de facturation. Au lieu de cela, ils utilisent des factures pour définir l’étendue des coûts de périodes de facturation spécifiques. L’API Billing Periods (Périodes de facturation) est remplacé par l’API Invoices (Factures). Toutes les API de consommation sont remplacées par des API Azure natives qui utilisent Microsoft Entra ID pour l’authentification et l’autorisation. Pour plus d’informations sur l’appel des API REST Azure, consultez Prise en main de REST.

Pour obtenir des factures avec l’API Invoices :

API Price Sheet

Cette section décrit les versions de l’API Price Sheet (Grille tarifaire) existantes et fournit des suggestions pour utiliser l’API Price Sheet avec les contrats client Microsoft (MCA). Elle décrit également l’API Price Sheet pour les contrats client Microsoft (MCA) et présente les champs des grilles tarifaires. Les API Enterprise Get Price Sheet et Enterprise Get Billing Periods sont remplacés par l’API Price Sheet pour les contrats client Microsoft (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). La nouvelle API prend en charge les formats JSON et CSV, dans des formats REST asynchrones. Toutes les API de consommation sont remplacées par des API Azure natives qui utilisent Microsoft Entra ID pour l’authentification et l’autorisation. Pour plus d’informations sur l’appel des API REST Azure, consultez Prise en main de REST.

Versions de l’API Billing Enterprise (Facturation d’entreprise)

Les versions de l’API Billing Enterprise étaient utilisées conjointement aux accords de mise en œuvre Entreprise pour obtenir des informations sur les prix et la période de facturation. L’authentification et l’autorisation ont utilisé des jetons web Microsoft Entra.

Pour obtenir les prix applicables pour l’accord de mise en œuvre d’entreprise spécifié avec les API Price Sheet et Billing Period :

API Price Sheet pour les contrats client Microsoft

Utilisez l’API Price Sheet pour les contrats client Microsoft, afin d’afficher les prix pour tous les services Azure Consumption, ainsi que la consommation de la Place de marché. Les prix indiqués dans le profil de facturation s’appliquent à tous les abonnements qui appartiennent au profil de facturation.

Utiliser l’API Price Sheet pour afficher toutes les données de grille tarifaire Azure Consumption au format CSV :

Utiliser l’API Price Sheet pour afficher toutes les données de grille tarifaire Azure Consumption au format JSON :

Utilise l’API pour retourner la grille tarifaire de l’intégralité du compte. Toutefois, vous pouvez également obtenir une version condensée de la grille tarifaire au format PDF. Ce résumé inclut les services Azure Consumption, ainsi que la consommation de la Place de marché, qui sont facturés pour une facture spécifique. La facture est identifiée par le un élément {invoiceId}, qui correspond au Numéro de facture indiqué dans les fichiers PDF Invoice Summary (Récapitulatif de la facture). Voici un exemple.

Pour afficher les informations de facturation avec l’API Price Sheet au format CSV :

Pour afficher les informations de facturation avec l’API Price Sheet au format JSON :

Vous pouvez également voir les prix estimés pour n’importe quel service Azure Consumption, ainsi que la consommation de la Place de marché, dans le cycle de facturation ou la période du service en cours.

Pour afficher les prix estimés pour les services de consommation avec l’API Price Sheet au format CSV :

Pour afficher les prix estimés pour les services de consommation avec l’API Price Sheet au format JSON :

Les version de l’API Microsoft Customer Agreement Price Sheet sont des API REST asynchrones. Les réponses pour les API ont changé par rapport aux API synchrones précédentes. Le corps de la réponse de l’API a aussi changé.

Ancien corps de la réponse

Voici un exemple de la réponse de l’API REST synchrone :

[
        {
            "id": "enrollments/573549891/billingperiods/2016011/products/343/pricesheets",
            "billingPeriodId": "201704",
            "meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
            "meterName": "A1 VM",
            "unitOfMeasure": "100 Hours",
            "includedQuantity": 0,
            "partNumber": "N7H-00015",
            "unitPrice": 0.00,
            "currencyCode": "USD"
        },
        {
    ]

Nouveau corps de la réponse

Les API prennent en charge le format Azure REST asynchrone. Si vous appelez l’API à l’aide de la méthode GET, vous recevez la réponse suivante :

No Response Body

HTTP Status 202 Accepted

Les en-têtes suivants sont envoyés à l’emplacement de la sortie :

Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Azure-AsyncOperation:https://managment.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Retry-After: 10

OData-EntityId: {operationId}

Effectuez un autre appel GET vers l’emplacement. La réponse de l’appel GET est la même, jusqu’à ce que l’opération atteigne un état d’achèvement ou d’échec. Une fois l’opération terminée, la réponse à l’emplacement d’appel GET retourne l’URL de téléchargement comme si l’opération avait été exécutée en même temps. Voici un exemple :

HTTP Status 200

{
  "id": "providers/Microsoft.Consumption/operationresults/{operationId}",
  "name": {operationId},
  "type": “Microsoft.Consumption/operationResults",
  "properties" : {
    "downloadUrl": {urltoblob},
    "validTill": "Date"
  }
}

Le client peut également effectuer un appel GET pour Azure-AsyncOperation. Le point de terminaison retourne l’état de l’opération.

Le tableau suivant affiche les champs de l’ancienne grille tarifaire de l’API Enterprise Get. Il inclut les champs correspondants dans la nouvelle grille tarifaire des contrats client Microsoft :

Opérations de l’API Consumption Price Sheet

Pour les contrats Entreprise, vous avez utilisé les opérations Get (Obtenir) et Get By Billing Period (Obtenir par période de facturation) de l’API Consumption Price Sheet pour une étendue selon l’élément subscriptionId ou pour établir une période de facturation. L’API utilise l’authentification Azure Resource Management.

Pour obtenir les informations grille tarifaire tarification pour une étendue avec l’API Price Sheet :

Pour obtenir des informations de grille tarifaire avec l’API Price Sheet :

Au lieu des points de terminaison d’API ci-dessus, utilisez les options suivantes pour les contrats client Microsoft :

API Price Sheet pour les contrats client Microsoft (API REST asynchrone)

Cette API concerne les contrats client Microsoft et fournit des attributs supplémentaires.

API Price Sheet pour une étendue de profil de facturation dans un compte de facturation

Cette API est l’API existante. Elle a été mise à jour afin de fournir la grille tarifaire pour un profil de facturation dans un compte de facturation.

API Price Sheet pour une étendue par compte de facturation

L’authentification Azure Resource Manager est utilisée lorsque vous obtenez l’API Price Sheet au niveau de l’étendue d’accord de mise en œuvre dans un compte de facturation.

Pour obtenir l’API Price Sheet pour le compte d’accord de mise en œuvre dans une table de tarification dans un compte de facturation :

Pour un contrat client Microsoft, utilisez les informations dans la section suivante. Vous y trouverez les propriétés de champ utilisées pour les contrats client Microsoft.

API Price Sheet pour une étendue de profil de facturation dans un compte de facturation

L’API Price Sheet mise à jour par l’API Billing Account obtient la grille tarifaire au format CSV. Pour obtenir la grille tarifaire dans l’étendue de profil de facturation pour un MCA :

Au niveau de la portée de l’accord de mise en œuvre, la réponse et les propriétés de l’API sont identiques. Les propriétés correspondent aux mêmes propriétés MCA.

Le tableau suivant répertorie les anciennes propriétés des versions de l’API Azure Resource Manager Price Sheet et les nouvelles propriétés équivalentes.

Le prix pour les contrats client Microsoft n’est pas défini comme celui des contrats Entreprise. Le prix des services lors de l’accord de mise en œuvre Entreprise est unique pour le produit, le numéro de référence, la mesure et l’offre. Le numéro de référence n’est pas utilisé dans les contrats client Microsoft.

Le prix du service Azure Consumption qui fait partie d’un Contrat client Microsoft est unique pour les éléments productOrderName et meterID. Ils représentent le compteur de service et l’offre du produit.

Pour concilier la grille tarifaire et son utilisation dans l’API Usage Details, vous pouvez utiliser les éléments productOrderName et meterID.

Les utilisateurs qui ont des droits de propriétaire de profil de facturation, de contributeur, de lecteur et de gestionnaire de facture peuvent télécharger la grille tarifaire.

La grille tarifaire inclut les prix des services basés sur leur utilisation. Les services incluent Azure Consumption et la consommation de la Place de marché. Le dernier prix à la fin de chaque période de service est verrouillé et appliqué à l’utilisation au cours d’une seule période de service. Pour les services Azure Consumption, la période de service est généralement d’un mois calendaire.

Champs de l’API Price Sheet supprimés

Les champs suivants ne sont pas disponibles dans l’API Microsoft Customer Agreement Price Sheet ou correspondent à des champs identiques.

Remplacement de l’API Reservation Instance Charge

L’API Reserved Instance Charge (Frais d’instance réservés) permet d’obtenir les transactions de facturation pour les achats de réservation. La nouvelle API inclut tous les achats, y compris des offres tierces de la Place de marché. Toutes les API de consommation sont remplacées par des API Azure natives qui utilisent Microsoft Entra ID pour l’authentification et l’autorisation. Pour plus d’informations sur l’appel des API REST Azure, consultez Prise en main de REST. L’API Reserved Instance Charge est remplacée par l’API Transactions.

Pour obtenir des transactions d’achats de réservations avec l’API Transactions :

Remplacement des versions de l’API Recommendations

Les versions de l’API Reserved Instance Purchase Recommendations fournissent des informations sur l’utilisation de la machine virtuelle sur les 7, 30 ou 60 derniers jours. Les versions de cette API fournissent également des recommandations d’achats de réservations. Notamment :

• API Shared Reserved Instance Recommendation (Recommandation relative à l’instance réservée partagée)
• API Single Reserved Instance Recommendations (Recommandation relative à l’instance réservée unique)

Toutes les API de consommation sont remplacées par des API Azure natives qui utilisent Microsoft Entra ID pour l’authentification et l’autorisation. Pour plus d’informations sur l’appel des API REST Azure, consultez Prise en main de REST. Les API de recommandations de réservations répertoriées précédemment sont remplacées par l’API Microsoft.Consumption/reservationRecommendations.

Pour obtenir des suggestions de réservations avec l’API Reservation Recommendations :

Remplacement de l’API Reservation Usage

L’API Reserved Instance Usage permet d’obtenir des informations sur l’utilisation des réservations dans un accord de mise en œuvre. S’il existe plusieurs instances réservées dans un accord de mise en œuvre, vous pouvez également obtenir l’utilisation de tous les achats de l’instance réservée à l’aide de cette API.

Notamment :

• Détails de l’utilisation de l’instance réservée
• Résumé de l’utilisation de l’instance réservée

Toutes les API de consommation sont remplacées par des API Azure natives qui utilisent Microsoft Entra ID pour l’authentification et l’autorisation. Pour plus d’informations sur l’appel des API REST Azure, consultez Prise en main de REST. Les API de suggestions de réservation répertoriées précédemment sont remplacées par les API Microsoft.Consumption/reservationDetails et Microsoft.Consumption/reservationSummaries.

Pour obtenir les détails des réservations avec l’API Reservation Details :

Pour obtenir des résumés des réservations avec l’API Reservation Summaries :

Intégration Power BI

Vous pouvez également utiliser Power BI pour la création de rapports de coûts. Le connecteur Cost Management pour Power BI Desktop permet de créer des rapports puissants et personnalisés pour mieux comprendre vos dépenses Azure. Le connecteur Cost Management prend actuellement en charge les clients avec un contrat client Microsoft ou un Contrat Entreprise.

Contenu connexe

• Consultez la documentation de Cost Management pour apprendre à surveiller et contrôler les dépenses Azure. Cette documentation est aussi utile si vous souhaitez optimiser l’utilisation de vos ressources avec Cost Management.