Migrer à partir de l’API Consumption Usage Details
Cet article traite de la migration à partir de l’API Détails de l’utilisation de la consommation, qui est prévue pour la dépréciation. La date exacte de dépréciation est toujours déterminée. Nous vous recommandons de ne pas générer vos pipelines de création de rapports à l’aide de cette API et de les migrer dès que possible.
Les API de création de rapports Contrat Entreprise (EA), qui utilisent une clé API pour l’authentification et sont accessibles via le point de terminaison d’URI consumption.azure.com, sont supprimées. Les clients EA qui utilisent ces API doivent migrer vers l’API Gestion des coûts Détails des coûts. Ces API de création de rapports EA plus anciennes sont uniquement disponibles pour les clients disposant d’un contrat Entreprise.
Si vous utilisez l’API Détails de l’utilisation de la consommation, nous vous recommandons, mais ne vous obligez pas à migrer vers l’API Gestion des coûts Détails des coûts.
Les API Consommation et Gestion des coûts sont disponibles pour les clients contrat client MICROSOFT EA (MCA). Par conséquent, les clients Azure Government qui restent sous contrat EA ne sont pas affectés négativement.
Lorsque vous migrez d’EA vers MCA, nous vous recommandons de passer de l’API Détails de l’utilisation des rapports EA à l’API Gestion des coûts et Détails des coûts et d’utiliser les exportations.
Destinations de migration
Lisez l’article Choisir une solution de détails sur les coûts avant de choisir la solution adaptée à votre charge de travail. En règle générale, nous vous recommandons d’effectuer des exportations si vous avez des besoins d’ingestion continue de données et un jeu de données de détails d’utilisation mensuelle volumineux. Pour plus d’informations, consultez Ingérer des données sur les détails des coûts.
Si vous disposez d’un jeu de données de détails d’utilisation plus petit ou d’un scénario qui n’est pas satisfait par les exportations, envisagez plutôt d’utiliser le rapport Détails des coûts. Pour plus d’informations, consultez Obtenir des jeux de données à faible coût à la demande.
Notes
Le rapport Détails des coûts est uniquement disponible pour les clients disposant d’un Accord Entreprise ou d’un Contrat client Microsoft. Si vous disposez d’un abonnement MSDN, paiement à l’utilisation ou Visual Studio, vous pouvez migrer vers des exportations ou continuer à utiliser l’API Consumption Usage Details.
Avantages de la migration
De nouvelles solutions offrent de nombreux avantages sur l’API Consumption Usage Details. Voici un résumé :
- Jeu de données unique pour tous les détails d’utilisation : les détails de l’utilisation d’Azure et de la Place de marché Azure ont été fusionnés dans un même jeu de données. Il réduit le nombre d’API que vous devez appeler pour afficher tous vos frais.
- Scalabilité : l’API Marketplaces est déconseillée, car elle promeut un modèle d’appel qui ne peut pas être mis à l’échelle à mesure que votre utilisation d’Azure augmente. Le jeu de données détails de l’utilisation peut être volumineux lorsque vous déployez plus de ressources dans le cloud. L’API Marketplaces est une API synchrone paginée : elle n’est dont pas optimisée pour transférer efficacement de grands volumes de données sur un réseau avec une efficacité et une fiabilité élevées. Les exportations et l’API de détails des coûts sont asynchrones. Elles vous fournissent un fichier CSV qui peut être téléchargé directement sur le réseau.
- Améliorations de l’API : les exportations et l’API de détails des coûts sont les solutions qu’Azure prend en charge à l’avenir. Toutes les nouvelles fonctionnalités y ont été intégrées.
- Cohérence du schéma : le rapport des détails des coûts et les exportations fournissent des fichiers avec des champs correspondants que vous pouvez déplacer d’une solution à l’autre, en fonction de votre scénario.
- Intégration de l’allocation des coûts : les clients Accord Entreprise et Contrat client Microsoft utilisant les exportations ou l’API Détails des coûts peuvent afficher les frais par rapport aux règles d’allocation des coûts qu’ils ont configurées. Pour plus d’informations sur l’allocation des coûts, consultez Allocation des coûts.
Différences de champ
Le tableau suivant récapitule les différences de champ entre l’API Consumption Usage Details et les API Exportation/Détails des coûts. Les API Exportations et Détails des coûts permettent de télécharger un fichier CSV au lieu de la réponse JSON paginés fournie par l’API Consumption.
Mappage du champ Accord Entreprise
Les clients Accord Entreprise qui utilisent l’API Consumption Usage Details ont des enregistrements de détails d’utilisation du type legacy. Tous les clients Accord Entreprise ont des enregistrements de ce type en raison du système de facturation sous-jacent utilisé pour eux. Voici un exemple d’enregistrement de détails d’utilisation hérité :
{
"value": [
{
"id": "{id}",
"name": "{name}",
"type": "Microsoft.Consumption/usageDetails",
"kind": "legacy",
"tags": {
"env": "newcrp",
"dev": "tools"
},
"properties": {
…...
}
}
Un exemple complet d’enregistrement de détails d’utilisation hérité est affiché dans Détails de l’utilisation - Liste - API REST (Consommation Azure)
Le tableau suivant fournit un mappage entre les anciens et les nouveaux champs. De nouvelles propriétés sont disponibles dans les fichiers CSV produits par les API d’exportation et de détails des coûts. Pour en savoir plus sur les champs, consultez Comprendre les champs d’utilisation.
Les noms de propriétés en gras sont inchangés.
| Ancienne propriété | Nouvelle propriété |
|---|---|
| accountName | AccountName |
| AccountOwnerId | AccountOwnerId |
| additionalInfo | AdditionalInfo |
| AvailabilityZone | AvailabilityZone |
| billingAccountId | BillingAccountId |
| billingAccountName | BillingAccountName |
| billingCurrency | BillingCurrencyCode |
| billingPeriodEndDate | BillingPeriodEndDate |
| billingPeriodStartDate | BillingPeriodStartDate |
| billingProfileId | BillingProfileId |
| billingProfileName | BillingProfileName |
| chargeType | ChargeType |
| consumedService | ConsumedService |
| cost | CostInBillingCurrency |
| costCenter | CostCenter |
| date | Date |
| effectivePrice | EffectivePrice |
| frequency | Fréquence |
| invoiceSection | InvoiceSectionName |
| InvoiceSectionId | InvoiceSectionId |
| isAzureCreditEligible | IsAzureCreditEligible |
| meterCategory | MeterCategory |
| meterId | ID du compteur |
| meterName | MeterName |
| MeterRegion | MeterRegion |
| meterSubCategory | MeterSubCategory |
| offerId | OfferId |
| partNumber | PartNumber |
| PayGPrice | PayGPrice |
| PlanName | PlanName |
| PricingModel | PricingModel |
| product | ProductName |
| ProductOrderId | ProductOrderId |
| ProductOrderName | ProductOrderName |
| PublisherName | PublisherName |
| PublisherType | PublisherType |
| quantité | Quantité |
| ReservationId | ID de réservation |
| ReservationName | ReservationName |
| resourceGroup | ResourceGroup |
| resourceId | ResourceId |
| resourceLocation | ResourceLocation |
| resourceName | Nom_ressource |
| serviceFamily | ServiceFamily |
| ServiceInfo1 | ServiceInfo1 |
| ServiceInfo2 | ServiceInfo2 |
| subscriptionId | SubscriptionId |
| subscriptionName | SubscriptionName |
| Balises | Balises |
| Terme | Terme |
| unitOfMeasure | UnitOfMeasure |
| unitPrice | UnitPrice |
| CostAllocationRuleName | CostAllocationRuleName |
Mappage de champs Contrat client Microsoft
Les clients Contrat client Microsoft qui utilisent l’API Consumption Usage Details ont des enregistrements de détails d’utilisation du type modern. Tous les Contrats client Microsoft ont des enregistrements de ce type en raison du système de facturation sous-jacent qui est utilisé pour eux. Voici un exemple d’enregistrement des détails d’utilisation MCA :
{
"value": [
{
"id": "{id}",
"name": "{name}",
"type": "Microsoft.Consumption/usageDetails",
"kind": "modern",
"tags": {
"env": "newcrp",
"dev": "tools"
},
"properties": {
…...
}
}
Un exemple complet d’enregistrement de détails d’utilisation hérité est affiché dans Détails de l’utilisation - Liste - API REST (Consommation Azure)
Un mappage entre les anciens et les nouveaux champs s’affiche dans le tableau suivant. De nouvelles propriétés sont disponibles dans les fichiers CSV produits par les API d’exportation et de détails des coûts. Les champs qui ont besoin d’un mappage en raison de différences entre les solutions sont affichés en gras.
Pour plus d’informations, consultez les champs Comprendre les détails de l’utilisation.
| Ancienne propriété | Nouvelle propriété |
|---|---|
| invoiceId | invoiceId |
| previousInvoiceId | previousInvoiceId |
| billingAccountId | billingAccountId |
| billingAccountName | billingAccountName |
| billingProfileId | billingProfileId |
| billingProfileName | billingProfileName |
| invoiceSectionId | invoiceSectionId |
| invoiceSectionName | invoiceSectionName |
| partnerTenantId | partnerTenantId |
| partnerName | partnerName |
| resellerName | resellerName |
| resellerMpnId | resellerMpnId |
| customerTenantId | customerTenantId |
| customerName | customerName |
| costCenter | costCenter |
| billingPeriodEndDate | billingPeriodEndDate |
| billingPeriodStartDate | billingPeriodStartDate |
| servicePeriodEndDate | servicePeriodEndDate |
| servicePeriodStartDate | servicePeriodStartDate |
| Date | Date |
| serviceFamily | serviceFamily |
| productOrderId | productOrderId |
| productOrderName | productOrderName |
| consumedService | consumedService |
| meterId | meterId |
| meterName | meterName |
| meterCategory | meterCategory |
| meterSubCategory | meterSubCategory |
| meterRegion | meterRegion |
| productIdentifier | ProductId |
| product | ProductName |
| subscriptionGuid | SubscriptionId |
| subscriptionName | subscriptionName |
| publisherType | publisherType |
| publisherId | publisherId |
| publisherName | publisherName |
| resourceGroup | resourceGroupName |
| INSTANCENAME | ResourceId |
| resourceLocationNormalized | location |
| resourceLocation | location |
| effectivePrice | effectivePrice |
| quantité | quantité |
| unitOfMeasure | unitOfMeasure |
| chargeType | chargeType |
| billingCurrencyCode | billingCurrency |
| pricingCurrencyCode | pricingCurrency |
| costInBillingCurrency | costInBillingCurrency |
| costInPricingCurrency | costInPricingCurrency |
| costInUsd | costInUsd |
| paygCostInBillingCurrency | paygCostInBillingCurrency |
| paygCostInUSD | paygCostInUsd |
| exchangeRatePricingToBilling | exchangeRatePricingToBilling |
| exchangeRateDate | exchangeRateDate |
| isAzureCreditEligible | isAzureCreditEligible |
| serviceInfo1 | serviceInfo1 |
| serviceInfo2 | serviceInfo2 |
| additionalInfo | additionalInfo |
| tags | tags |
| partnerEarnedCreditRate | partnerEarnedCreditRate |
| partnerEarnedCreditApplied | partnerEarnedCreditApplied |
| marketPrice | PayGPrice |
| frequency | frequency |
| terme | terme |
| reservationId | reservationId |
| reservationName | reservationName |
| pricingModel | pricingModel |
| unitPrice | unitPrice |
| exchangeRatePricingToBilling | exchangeRatePricingToBilling |
Contenu connexe
- En savoir plus sur l’automatisation de Cost Management + Facturation dans la vue d’ensemble automatisation de Cost Management.