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.
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|csv Microsoft.Billing/billingAccounts/…/billingProfiles/…/invoices/… /pricesheet/default/download format=json|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/reservationDetailsMicrosoft.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’API Get Balance Summary (Obtenir le résumé du solde) vous fournit un résumé mensuel des :
- 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.
- Get usage detail/download
- Obtenir les détails de l’utilisation/envoyer
- Get usage detail/usagedetails
- Get usage detail/usagedetailsbycustomdate
- Get marketplace store charge/marketplacecharges
- Get marketplace store charge/marketplacechargesbycustomdate
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 | Aucun | |
| 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.
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/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/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/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/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/28ae4b7f-41bb-581e-9fa4-8270c857aa5f/billingProfiles/ef37facb-cd6f-437a-9261-65df15b673f9/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 :
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.
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.
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour