Partager via


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.

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.

Remarque

Toutes les API de création de rapports Azure Enterprise sont mises hors service. Vous devriez effectuer la migration vers les API Microsoft Cost Management dès que possible.

Objectif API EA API MCA
Solde et crédits /balancesummary Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae
Utilisation (JSON) /usagedetails
/usagedetailsbycustomdate
Choisir une solution de détails des coûts
Utilisation (CSV) /usagedetails/download
/usagedetails/submit
Choisir une solution de détails des coûts
Utilisation de la Place de marché (CSV) /marketplacecharges
/marketplacechargesbycustomdate
Choisir une solution de détails des coûts
Billing periods /billingperiods Microsoft.Billing/billingAccounts/billingProfiles/invoices
Price sheet /pricesheet Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json ou csv
Microsoft.Billing/billingAccounts/…/billingProfiles/…/invoices/… /pricesheet/default/download format=json ou csv
Microsoft.Billing/billingAccounts/../billingProfiles/../providers/Microsoft.Consumption/pricesheets/download
Achats de réservation /reservationcharges Microsoft.Billing/billingAccounts/billingProfiles/transactions
Reservation recommendations /SharedReservationRecommendations
/SingleReservationRecommendations
Microsoft.Consumption/reservationRecommendations
Utilisation de la réservation /reservationdetails
/reservationsummaries
Microsoft.Consumption/reservationDetails
Microsoft.Consumption/reservationSummaries

¹ 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 :

Objectif API Microsoft Customer Agreement (MCA)
Comptes de facturation² Microsoft.Billing/billingAccounts
Profils de facturation² Microsoft.Billing/billingAccounts/billingProfiles
Sections de facture² Microsoft.Billing/billingAccounts/invoiceSections
Factures Microsoft.Billing/billingAccounts/billingProfiles/invoices
Abonnements de facturation {scope}/billingSubscriptions

² 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 :

Objectif Ancienne offre Nouvelle offre
Power BI Microsoft Consumption Insights pack de contenu et connecteur Connecteur Azure Consumption Insights

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 :

Méthode URI de demande
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview

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.

Type Format d’ID
Compte de facturation /Microsoft.Billing/billingAccounts/{billingAccountId}
Profil de facturation /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}
Abonnement /subscriptions/{subscriptionId}
Resource group /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}

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.

Ancienne propriété Nouvelle propriété Notes
AccountId N/A Le créateur de l’abonnement n’est pas suivi. Utilisez invoiceSectionId (identique à departmentId).
AccountNameAccountOwnerId et AccountOwnerEmail N/A Le créateur de l’abonnement n’est pas suivi. Utilisez invoiceSectionName (identique à departmentName).
AdditionalInfo additionalInfo
ChargesBilledSeparately isAzureCreditEligible Les propriétés sont opposées. Si isAzureCreditEnabled a la valeur true, ChargesBilledSeparately a la valeur false.
ConsumedQuantity quantité
ConsumedService consumedService Les valeurs précises des chaînes peuvent différer.
ConsumedServiceId Aucun
CostCenter costCenter
Date et usageStartDate Date
Jour Aucun Analyse le jour à partir de la date.
DepartmentId invoiceSectionId Les valeurs précises diffèrent.
DepartmentName invoiceSectionName Les valeurs précises des chaînes peuvent différer. Permet de configurer les sections de vos factures en fonction des services impliqués, si nécessaire.
ExtendedCost et Cost costInBillingCurrency
InstanceId resourceId
Is Recurring Charge Aucune
Emplacement location
MeterCategory meterCategory Les valeurs précises des chaînes peuvent différer.
MeterId meterId Les valeurs précises des chaînes diffèrent.
MeterName meterName Les valeurs précises des chaînes peuvent différer.
MeterRegion meterRegion Les valeurs précises des chaînes peuvent différer.
MeterSubCategory meterSubCategory Les valeurs précises des chaînes peuvent différer.
Month Aucun Analyse le mois à partir de la date.
Nom de l’offre Aucun Utilisez publisherName et productOrderName.
OfferID Aucun
Order Number Aucun
PartNumber Aucun Utilisez meterId et productOrderName pour identifier les prix de manière unique.
Nom du plan productOrderName
Produit Produit
ProductId productId Les valeurs précises des chaînes diffèrent.
Nom de l’éditeur publisherName
ResourceGroup resourceGroupName
ResourceGuid meterId Les valeurs précises des chaînes diffèrent.
ResourceLocation resourceLocation
ResourceLocationId Aucune
Nom_ressource Aucune
ResourceRate effectivePrice
ServiceAdministratorId N/A
ServiceInfo1 serviceInfo1
ServiceInfo2 serviceInfo2
NomService meterCategory Les valeurs précises des chaînes peuvent différer.
ServiceTier meterSubCategory Les valeurs précises des chaînes peuvent différer.
StoreServiceIdentifier N/A
SubscriptionGuid subscriptionId
SubscriptionId subscriptionId
SubscriptionName subscriptionName
Balises tags La propriété des balises s’applique à l’objet racine, et non à la propriété imbriquée des propriétés.
UnitOfMeasure unitOfMeasure Les valeurs précises des chaînes diffèrent.
usageEndDate Date
Year Aucun Analyse l’année à partir de la date.
(nouveau) billingCurrency Devise utilisée pour les frais.
(nouveau) billingProfileId ID unique pour le profil de facturation (identique à l’inscription).
(nouveau) billingProfileName Nom du profil de facturation (identique à l’inscription).
(nouveau) chargeType Permet de différencier l’utilisation des services Azure, l’utilisation de la Place de marché et les achats.
(nouveau) invoiceId ID unique de la facture. Vide pour le mois ouvert en cours.
(nouveau) publisherType Type de serveur de publication pour les achats. Vide pour l’utilisation.
(nouveau) serviceFamily Type d’achat. Vide pour l’utilisation.
(nouveau) servicePeriodEndDate Date de fin pour le service acheté.
(nouveau) servicePeriodStartDate Date de début pour le service acheté.

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 :

Méthode URI de demande
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview

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 :

Méthode URI de demande
GET https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet
GET https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet

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 :

Méthode URI de demande
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=csv

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

Méthode URI de demande
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&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.

Capture d’écran montrant le numéro de facture correspondant à l’ID de facture.

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

Méthode URI de demande
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv

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

Méthode URI de demande
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&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 :

Méthode URI de demande
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv

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

Méthode URI de demande
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&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 :

Ancienne propriété Nouvelle propriété Notes
billingPeriodId Non applicable Non applicable. Pour les contrats client Microsoft, la facture et grille tarifaire associée ont remplacé le concept de billingPeriodId.
meterId meterId
unitOfMeasure unitOfMeasure Les valeurs précises des chaînes peuvent différer.
includedQuantity includedQuantity Non applicable pour les services dans les contrats client Microsoft.
partNumber Non applicable Au lieu de cela, utilisez une combinaison de productOrderName (identique à offerID) et meterID.
unitPrice unitPrice L’élément unitPrice (prix unitaire) est applicable pour les services utilisés dans les contrats client Microsoft.
currencyCode pricingCurrency Les contrats client Microsoft représentent les prix dans les devises de tarification et de facturation. L’élément currencyCode (Code de la devise) correspond à l’élément pricingCurrency (Devise de tarification) dans les contrats client Microsoft.
offerID productOrderName Au lieu de OfferID, vous pouvez utiliser productOrderName. Cependant, cet élément n’est pas identique à OfferID. Toutefois, les éléments productOrderName et meter déterminent la tarification dans les contrats client Microsoft liées aux éléments meterId et OfferID dans les accords de mise en œuvre hérités.

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 :

Méthode URI de demande
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01

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

Méthode URI de demande
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01

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 :

Méthode URI de demande
GET /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01

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 :

Méthode URI de demande
GET /providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01

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.

Ancienne propriété de l’API Azure Resource Manager Price Sheet Nouvelle propriété de l’API Microsoft Customer Agreement Price Sheet Description
Meter ID meterId Identificateur unique du compteur. Identique à meterID.
Nom du compteur meterName Nom du compteur. Le compteur représente la ressource déployable d’un service Azure.
Catégorie du compteur service Nom de la catégorie de classification du compteur. Identique au service de Microsoft Customer Agreement Price Sheet. Les valeurs précises des chaînes diffèrent.
Sous-catégorie du compteur meterSubCategory Nom de la catégorie de sous-classification du compteur. Basé sur la classification de la différenciation des jeux de caractéristiques de haut niveau dans le service. Par exemple, base de données SQL de Base et base de données SQL standard.
Région du compteur meterRegion
Unité Non applicable Peut être analysé à partir de l’élément unitOfMeasure.
Unité de mesure unitOfMeasure
Numéro de référence Non applicable Au lieu d’un numéro de référence, utilisez productOrderName et MeterID pour identifier de façon unique le prix pour un profil de facturation. Les champs sont répertoriés sur la facture MCA plutôt que le numéro de référence dans les factures MCA.
Prix unitaire unitPrice Prix unitaire du contrat client Microsoft.
Code devise pricingCurrency Les contrats client Microsoft représentent les prix dans les devises de tarification et de facturation. Le code de la devise correspond à l’élément pricingCurrency (Devise de tarification) dans les contrats client Microsoft.
Quantité incluse includedQuantity Non applicable aux services dans les contrats client Microsoft. S’affiche avec des valeurs égales à zéro.
ID de l’offre productOrderName Au lieu de OfferID, utilisez productOrderName. Diffère de l’élément OfferID. Cependant les éléments productOrderName et meter (compteur) déterminent la tarification dans les contrats client Microsoft. Lié aux éléments meterId et OfferID dans les accords de mise en œuvre hérités.

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.

Champ supprimé Description
billingPeriodId Non applicable. Correspond à l’élément InvoiceId pour un MCA.
offerID Non applicable. Correspond à l’élément productOrderName pour un MCA.
meterCategory Non applicable. Correspond au à l’élément Service pour un MCA.
unité Non applicable. Peut être analysé à partir de l’élément unitOfMeasure.
currencyCode Identique à l’élément pricingCurrency pour un MCA.
meterLocation Identique à l’élément meterRegion pour un MCA.
partNumber Non applicable, car le numéro de référence n’est pas répertorié dans les factures MCA. Au lieu du numéro de référence, utilisez la combinaison des éléments meterId et productOrderName pour identifier les prix de manière unique.
totalIncludedQuantity Non applicable.
pretaxStandardRate Non applicable.

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 :

Méthode URI de demande
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview

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 :

Méthode URI de demande
GET https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01

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 :

Méthode URI de demande
GET https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01

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

Méthode URI de demande
GET https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01

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.

  • 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.