Migrer à partir des API Détails de l’utilisation EA
Les clients EA qui utilisaient auparavant les API Enterprise Reporting derrière le point de terminaison consumption.azure.com pour obtenir les détails de l’utilisation et les frais de la Place de marché doivent migrer vers des solutions nouvelles et améliorées. Les instructions à suivre sont décrites ci-dessous, ainsi que les différences de contrat entre l’ancienne API et les nouvelles solutions.
Le jeu de données est appelé détails des coûts au lieu de détails d’utilisation.
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.
Nouvelles solutions en disponibilité générale
Le tableau suivant fournit un résumé des destinations de migration disponibles, ainsi qu’un résumé des éléments à prendre en compte lors du choix de la solution qui vous convient le mieux.
| Solution | Description | Considérations | Informations d’intégration |
|---|---|---|---|
| Exports | Vidages de données périodiques dans le stockage selon une planification | - La solution la plus évolutive pour vos charges de travail. - Peut être configuré pour utiliser le partitionnement de fichiers pour les jeux de données plus volumineux. - Idéal pour établir et augmenter un jeu de données de coût qui peut être intégré à vos propres magasins de données interrogeables. - Nécessite l’accès à un compte de stockage qui peut contenir les données. |
- Configurer dans le portail Azure Automatiser la création d’exportations avec l’API - Référence de l’API d’exportation |
| API de détails des coûts | Téléchargement à la demande | - Utile pour les jeux de données à faible coût. - Utile pour les scénarios lorsque les exportations vers le stockage Azure ne sont pas réalisables en raison de problèmes de sécurité ou de facilité de gestion. |
- Obtenir des jeux de données à faible coût à la demande - API Détails des coûts |
En règle générale, nous vous recommandons d’utiliser des Exportations si vous avez des besoins d’ingestion continue de données et/ou un jeu de données de détails des coûts mensuels volumineux. Pour plus d’informations, consultez Ingestion des données de détails des coûts. Si vous avez besoin d’informations supplémentaires pour vous aider à prendre une décision pour votre charge de travail, consultez Choisir une solution de détails des coûts.
Attribuer des autorisations à un SPN pour appeler les API
Si vous voulez appeler les API Exportations ou Détails des coûts programmatiquement, vous devez configurer un principal de service avec l’autorisation appropriée. Pour plus d’informations, consultez Affecter des autorisations aux API ACM.
Éviter l’API Détails de l’utilisation de la consommation Microsoft
L’API Détails de l’utilisation de la consommation est un autre point de terminaison qui prend actuellement en charge les clients EA. Ne migrez pas vers cette API. Migrez vers les API Exportations ou Détails des coûts, comme indiqué précédemment dans ce document. L’API Détails d’utilisation de la consommation sera dépréciée à l’avenir et se trouve derrière le point de terminaison suivant.
GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2021-10-01
Cette API est un point de terminaison synchrone et ne peut pas être mise à l’échelle, car vos dépenses et la taille de votre jeu de données de coûts mensuels augmentent. Si vous utilisez actuellement l’API Détails de l’utilisation de la consommation, nous vous recommandons de la migrer vers l’API Exportations ou Détails des coûts dès que possible. Une annonce formelle de dépréciation sera faite à une date ultérieure. Pour en savoir plus sur la migration à partir des détails de l’utilisation de la consommation, consultez Migrer à partir de l’API Détails de l’utilisation de la consommation.
Avantages de la migration
Nos nouvelles solutions offrent de nombreux avantages par rapport aux API d’utilisation des rapports EA. Voici un résumé :
- Sécurité et stabilité : les nouvelles solutions nécessitent un principal de service et/ou des jetons utilisateur pour accéder aux données. Ils sont plus sécurisés que les clés API utilisées pour l’authentification auprès des API de création de rapports EA. Les clés de ces API héritées sont valides pendant six mois et peuvent exposer des données financières sensibles en cas de fuite. Par ailleurs, si les clés ne sont pas renouvelées et intégrées dans les charges de travail avant leur expiration de six mois, l’accès aux données est révoqué. Cela interrompt les charges de travail des clients.
- Scalabilité : les API de rapport EA ne sont pas conçues pour être mises à l’échelle, et votre utilisation Azure augmente. Le jeu de données des détails d’utilisation peut être extrêmement volumineux lorsque vous déployez plus de ressources dans le cloud. Les nouvelles solutions sont asynchrones et disposent d’améliorations étendues de l’infrastructure pour garantir des téléchargements réussis pour n’importe quelle taille de jeu de données.
- Un seul jeu de données 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 dans les nouvelles solutions. Le jeu de données unique réduit le nombre d’API que vous devez appeler pour voir tous vos frais.
- Amortissement de l’achat : les clients qui achètent des réservations peuvent voir une vue amortie de leurs coûts à l’aide des nouvelles solutions.
- Cohérence du schéma : chaque solution disponible fournit des fichiers avec des champs correspondants. Cela vous permet de passer facilement d’une solution à l’autre en fonction de votre scénario.
- Intégration de l’allocation des coûts : les clients Contrat Entreprise et Contrat client Microsoft peuvent utiliser la nouvelle solution pour voir les frais liés 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.
- Améliorations à l’avenir : les nouvelles solutions sont en cours de développement actif. Les solutions reçoivent toutes les nouvelles fonctionnalités dès qu’elles sont publiées.
API d’utilisation de l’entreprise à migrer hors service
Le tableau suivant récapitule les différentes API que vous utilisez peut-être aujourd’hui pour ingérer les données de détails des coûts. Si vous utilisez une des API suivantes, vous devez migrer vers une des nouvelles solutions décrites précédemment. Toutes les API se trouvent derrière le point de terminaison https://consumption.azure.com.
| Point de terminaison | Commentaires d’API |
|---|---|
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod} |
- Méthode d’API : GET - Synchrone (pas d’interrogation) - Format de données : CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10 |
- Méthode d’API : GET - Synchrone (pas d’interrogation) - Format de données : CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails |
- Méthode d’API : GET - Synchrone (pas d’interrogation) - Format de données : JSON |
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails |
- Méthode d’API : GET - Synchrone (pas d’interrogation) - Format de données : JSON |
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10 |
- Méthode d’API : GET - Synchrone (pas d’interrogation) - Format de données : JSON |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod} |
- Méthode d’API : POST - Asynchrone (basée sur l’interrogation) - Format de données : CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10 |
- Méthode d’API : POST - Asynchrone (basée sur l’interrogation) - Format de données : CSV |
Mappages de champs de données
Le tableau ci-dessous fournit un récapitulatif des anciens champs disponibles dans les solutions que vous utilisez actuellement, ainsi que le champ à utiliser dans les nouvelles solutions.
| Ancien champ | Nouveau champ | Commentaires |
|---|---|---|
| accountId | Non disponible : utiliser AccountName pour obtenir les informations du compte. | |
| accountName | AccountName | |
| accountOwnerEmail | AccountOwnerId | |
| additionalInfo | AdditionalInfo | |
| chargesBilledSeparately | isAzureCreditEligible | Les propriétés sont opposées. Si isAzureCreditEnabled est true, ChargesBilledSeparately est false. |
| consumedQuantity | Quantité | |
| consumedService | ConsumedService | |
| consumedServiceId | ConsumedService | consumedServiceId fournit uniquement une valeur numérique.ConsumedService indique le nom du service. |
| cost | CostInBillingCurrency | |
| costCenter | CostCenter | |
| date | Date | Le format de l’ancien champ était aaaa-mm-jj, et le nouveau champ est au format mm/jj/aaaa. |
| departmentId | InvoiceSectionId | Le champ est actuellement vide. Utilisez DepartmentName pour obtenir les informations du service. |
| departmentName | InvoiceSectionName | |
| extendedCost | CostInBillingCurrency | |
| instanceId | ResourceId | |
| isRecurringCharge | Si nécessaire, utilisez Frequency et Term fields à partir de maintenant. |
|
| location | ResourceLocationNormalized | ResourceLocationNormalized est présent dans le rapport Détails des coûts, mais pas encore dans les exportations. |
| meterCategory | MeterCategory | |
| meterId | ID du compteur | |
| meterName | MeterName | |
| meterRegion | MeterRegion | |
| meterSubCategory | MeterSubCategory | |
| offerId | OfferId | |
| orderNumber | Non disponible. | |
| partNumber | PartNumber | |
| planName | PlanName | |
| product | ProductName | |
| publisherName | PublisherName | |
| resourceGroup | ResourceGroup | |
| resourceGuid | ID du compteur | Les valeurs varient. resourceGuid est une valeur GUID. meterId est un nombre long. |
| resourceLocation | ResourceLocation | |
| resourceLocationId | Non disponible. | |
| resourceRate | EffectivePrice | |
| serviceInfo1 | ServiceInfo1 | |
| serviceInfo2 | ServiceInfo2 | |
| serviceName | MeterCategory | |
| serviceTier | MeterSubCategory | |
| storeServiceIdentifier | Non disponible. | |
| subscriptionGuid | SubscriptionId | |
| subscriptionId | SubscriptionId | |
| subscriptionName | SubscriptionName | |
| tags | Balises | Le nouveau champ n’a pas d’accolades ({}) autour des paires clé-valeur. |
| unitOfMeasure | UnitOfMeasure |