Partager via

Migrer à partir de l’API Consumption Usage Details

  • Article

Cet article traite de la migration à partir de l’API Consumption Usage Details. L’API Consumption Usage Details est déconseillée. La date à laquelle l’API sera désactivée n’a toujours pas été définie. Nous vous conseillons d’effectuer une migration depuis cette API dès que possible.

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 extrêmement 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 de 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. Un enregistrement de détails d’utilisation hérité est indiqué ci-dessous. Tous les clients Accord Entreprise ont des enregistrements de ce type en raison du système de facturation sous-jacent utilisé pour eux.

{  

  "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. Un enregistrement de détails d’utilisation moderne est illustré ci-dessous. 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.

{  

  "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