Utilisez les API de facturation Azure pour obtenir par programme des informations sur votre utilisation d’AzureUse Azure Billing APIs to programmatically get insight into your Azure usage

Utilisez les API de facturation Azure pour extraire les données d’utilisation et de ressources dans vos outils d’analyse de données préférés.Use Azure Billing APIs to pull usage and resource data into your preferred data analysis tools. Les API d’utilisation des ressources Azure et RateCard peuvent vous aider à prévoir vos coûts avec précision et à les gérer.The Azure Resource Usage and RateCard APIs can help you accurately predict and manage your costs. Les API sont implémentées en tant que fournisseur de ressources et font partie intégrante de la famille d’API exposées par Azure Resource Manager.The APIs are implemented as a Resource Provider and part of the family of APIs exposed by the Azure Resource Manager.

API Azure Invoice Download (version préliminaire)Azure Invoice Download API (Preview)

Une fois l’adhésion terminée, téléchargez des factures à l’aide de la version préliminaire de l’API Invoice.Once the opt-in has been complete, download invoices using the preview version of Invoice API. Cette API offre les fonctionnalités suivantes :The features include:

  • Contrôle d’accès en fonction du rôle Azure (RBAC Azure)  : configurez des stratégies d’accès sur le portail Azure ou via des cmdlets Azure PowerShell pour spécifier les utilisateurs ou applications pouvant accéder aux données d’utilisation de l’abonnement.Azure role-based access control (Azure RBAC) - Configure access policies on the Azure portal or through Azure PowerShell cmdlets to specify which users or applications can get access to the subscription’s usage data. Les appelants doivent utiliser les jetons Azure Active Directory standard pour l’authentification.Callers must use standard Azure Active Directory tokens for authentication. Ajoutez l’appelant au rôle Lecteur de facture, Lecteur, Propriétaire ou Collaborateur pour être en mesure d’accéder aux données d’utilisation relatives à un abonnement Azure spécifique.Add the caller to either the Billing Reader, Reader, Owner, or Contributor role to get access to the usage data for a specific Azure subscription.
  • Filtrage par date : utilisez le paramètre $filter pour obtenir toutes les factures par ordre chronologique inverse à partir de la date de fin de la période de facturation.Date Filtering - Use the $filter parameter to get all the invoices in reverse chronological order by the invoice period end date.

Notes

Cette fonctionnalité se trouve dans la première version de la version préliminaire et peut être sujette à des modifications à incompatibilité descendante.This feature is in first version of preview and may be subject to backward-incompatible changes. Elle n’est actuellement pas disponible pour certaines offres d’abonnement (EA, CSP, AIO non pris en charge) et Azure Allemagne.Currently, it's not available for certain subscription offers (EA, CSP, AIO not supported) and Azure Germany.

API Azure Resource Usage (version préliminaire)Azure Resource Usage API (Preview)

Utiliser l’API Azure Resource Usage pour obtenir une estimation de vos données de consommation Azure.Use the Azure Resource Usage API to get your estimated Azure consumption data. L’API comprend :The API includes:

  • Contrôle d’accès en fonction du rôle Azure (RBAC Azure)  : configurez des stratégies d’accès sur le portail Azure ou via des cmdlets Azure PowerShell pour spécifier les utilisateurs ou applications pouvant accéder aux données d’utilisation de l’abonnement.Azure role-based access control (Azure RBAC) - Configure access policies on the Azure portal or through Azure PowerShell cmdlets to specify which users or applications can get access to the subscription’s usage data. Les appelants doivent utiliser les jetons Azure Active Directory standard pour l’authentification.Callers must use standard Azure Active Directory tokens for authentication. Ajoutez l’appelant au rôle Lecteur de facture, Lecteur, Propriétaire ou Collaborateur pour être en mesure d’accéder aux données d’utilisation relatives à un abonnement Azure spécifique.Add the caller to either the Billing Reader, Reader, Owner, or Contributor role to get access to the usage data for a specific Azure subscription.
  • Agrégations horaires ou quotidiennes : les appelants peuvent indiquer s’ils souhaitent visualiser leurs données d’utilisation Azure par intervalles de temps horaires ou quotidiens.Hourly or Daily Aggregations - Callers can specify whether they want their Azure usage data in hourly buckets or daily buckets. Par défaut, les données sont présentées par jour.The default is daily.
  • Métadonnées d’instance (balises de ressource incluses)  : obtenez des détails de niveau instance, comme l’URI de ressource complet (/subscriptions/{subscription-id}/..) et des informations de groupe de ressources et les balises de ressource.Instance metadata (includes resource tags) – Get instance-level detail like the fully qualified resource uri (/subscriptions/{subscription-id}/..), the resource group information, and resource tags. Les métadonnées vous aideront à allouer de façon déterministe et par programme l’utilisation par les balises, pour les cas d’utilisation comme la facturation interne.This metadata helps you deterministically and programmatically allocate usage by the tags, for use-cases like cross-charging.
  • Métadonnées sur les ressources : des détails sur les ressources, comme le nom du compteur, la catégorie du compteur, la sous-catégorie du compteur, l’unité et la région offrent à l’appelant une meilleure compréhension des ressources consommées.Resource metadata - Resource details such as the meter name, meter category, meter sub category, unit, and region give the caller a better understanding of what was consumed. Nous nous efforçons également d’aligner la terminologie des métadonnées de ressource dans l’ensemble du portail Azure, des fichiers CSV sur l’utilisation d’Azure et sur la facturation Contrat Entreprise (EA), ainsi que dans toutes les autres expériences destinées au public, afin de vous permettre de mettre en corrélation les données des différentes expériences.We're also working to align resource metadata terminology across the Azure portal, Azure usage CSV, EA billing CSV, and other public-facing experiences, to let you correlate data across experiences.
  • Utilisation pour différents types d’offre : les données d’utilisation sont accessibles pour tous les types d’offre, tels que Paiement à l’utilisation, MSDN, Engagement monétaire, Crédit monétaire et Contrat Entreprise (EA), excepté CSP.Usage for different offer types – Usage data is available for offer types like Pay-as-you-go, MSDN, Monetary commitment, Monetary credit, and EA, except CSP.

API Azure Resource RateCard (version préliminaire)Azure Resource RateCard API (Preview)

Utilisez l’API Azure Resource RateCard pour obtenir la liste des ressources Azure disponibles et une estimation des informations de prix pour chacune de ces ressources.Use the Azure Resource RateCard API to get the list of available Azure resources and estimated pricing information for each. L’API comprend :The API includes:

  • Contrôle d’accès en fonction du rôle Azure (RBAC Azure)  : configurez vos stratégies d’accès sur le portail Azure ou via des cmdlets Azure PowerShell pour spécifier les utilisateurs ou les applications qui peuvent accéder aux données de RateCard.Azure role-based access control (Azure RBAC) - Configure your access policies on the Azure portal or through Azure PowerShell cmdlets to specify which users or applications can get access to the RateCard data. Les appelants doivent utiliser les jetons Azure Active Directory standard pour l’authentification.Callers must use standard Azure Active Directory tokens for authentication. Ajoutez l’appelant au rôle Lecteur, Propriétaire ou Collaborateur pour être en mesure d’accéder aux données d’utilisation relatives à un abonnement Azure particulier.Add the caller to either the Reader, Owner, or Contributor role to get access to the usage data for a particular Azure subscription.
  • Prise en charge des offres Paiement à l’utilisation, MSDN, Engagement monétaire et Crédit monétaire (offre EA et CSP non prises en charge)  : cette API fournit des informations de tarif au niveau des offres Azure.Support for Pay-as-you-go, MSDN, Monetary commitment, and Monetary credit offers (EA and CSP not supported) - This API provides Azure offer-level rate information. L’appelant de cette API doit transmettre les informations d’offre pour obtenir les détails et les tarifs des ressources.The caller of this API must pass in the offer information to get resource details and rates. Nous sommes actuellement pas en mesure de fournir les tarifs EA, car les offres EA présentent des tarifs par inscription personnalisés.We're currently unable to provide EA rates because EA offers have customized rates per enrollment.

ScénariosScenarios

Voici quelques-uns des scénarios autorisés par l’utilisation combinée des API Usage et RateCard :Here are some of the scenarios that are made possible with the combination of the Usage and the RateCard APIs:

  • Dépenses Azure au cours du mois : utilisez la combinaison des API d’utilisation et RateCard pour obtenir une meilleure idée de vos dépenses de cloud au cours du mois.Azure spend during the month - Use the combination of the Usage and RateCard APIs to get better insights into your cloud spend during the month. Vous pouvez analyser les compartiments horaires et quotidiens des estimations d’utilisation et de facturation.You can analyze the hourly and daily buckets of usage and charge estimates.

  • Configurer des alertes : utilisez les API d’utilisation et RateCard pour obtenir une estimation de la consommation et de la facturation, et configurer des alertes en fonction des ressources ou des valeurs monétaires.Set up alerts – Use the Usage and the RateCard APIs to get estimated cloud consumption and charges, and set up resource-based or monetary-based alerts.

  • Prédiction de facture : obtenez votre estimation de consommation et votre dépense cloud et appliquez des algorithmes d’apprentissage automatique pour prédire le montant de la facture à la fin du cycle de facturation.Predict bill – Get your estimated consumption and cloud spend, and apply machine learning algorithms to predict what the bill would be at the end of the billing cycle.

  • Analyse des coûts avant consommation : utilisez l’API RateCard pour prédire le montant de votre facture pour votre utilisation prévue lorsque vous déplacez vos charges de travail dans Azure.Pre-consumption cost analysis – Use the RateCard API to predict how much your bill would be for your expected usage when you move your workloads to Azure. Si vous disposez de charges de travail existantes dans d’autres clouds publics ou privés, vous pouvez également mapper votre utilisation sur les tarifs Azure afin d’obtenir une meilleure estimation de vos dépenses Azure.If you have existing workloads in other clouds or private clouds, you can also map your usage with the Azure rates to get a better estimate of Azure spend. Cette estimation vous donne la possibilité d’ajouter un tableau croisé dynamique sur l’offre et de comparer les différents types d’offre au-delà du paiement à l’utilisation, notamment l’engagement monétaire et crédit monétaire.This estimate gives you the ability to pivot on offer, and compare and contrast between the different offer types beyond Pay-As-You-Go, like Monetary commitment and Monetary credit. L’API vous donne également la possibilité de voir les différences de coût par région et vous permet d’effectuer une analyse de scénarios des coûts pour vous aider à prendre des décisions en matière de déploiement.The API also gives you the ability to see cost differences by region and allows you to do a what-if cost analysis to help you make deployment decisions.

  • Analyse de scénarios -What-if analysis -

    • Vous pouvez déterminer s’il est plus rentable d’exécuter les charges de travail dans une autre région ou dans une autre configuration de la ressource Azure.You can determine whether it is more cost-effective to run workloads in another region, or on another configuration of the Azure resource. Les coûts des ressources Azure peuvent varier en fonction de la région Azure que vous utilisez.Azure resource costs may differ based on the Azure region you're using.
    • Vous pouvez également déterminer si un autre type d’offre Azure propose un meilleur tarif pour une ressource Azure.You can also determine if another Azure offer type gives a better rate on an Azure resource.

Étapes suivantesNext steps