Consommation Azure

Les API Azure Consumption vous permettent d’accéder par programme aux données de coût et d’utilisation de vos ressources Azure. À l’heure actuelle, les API ne prennent en charge que les inscriptions d’entreprise, les abonnements Web Direct (à quelques exceptions près) et les abonnements au plan Azure CSP. Ces API sont continuellement mises à jour pour prendre en charge d’autres types d’abonnements Azure.

Les API Azure Consumption donnent accès aux éléments suivants :

• Clients Enterprise uniquement
  • Tableau des prix
  • Budgets
  • Prévisions
  • Balances
  • Étiquettes
  • Étiquettes de coût
• Clients Enterprise et Web Direct
  • Détails de la réservation
  • Résumés des réservations
  • Frais de la Place de marché
  • Détails de l’utilisation
  • Recommandations de réservation

Liste des types d’abonnement non pris en charge

• MS-AZR-0145P (CSP)
• MS-AZR-0146P (CSP)
• MS-AZR-159P (CSP)
• MS-AZR-0036P (sponsorisé)
• MS-AZR-0143P (sponsorisé)
• MS-AZR-0015P (interne)
• MS-AZR-0144P (DreamSpark)

Utilisation des périodes de facturation et des plages de dates

Les détails d’utilisation et les frais de la Place de marché acceptent les périodes de facturation ou les plages de dates pour définir les dates de début et de fin des données d’utilisation.

Voici le comportement de l’API basé sur les périodes de facturation et les plages de dates demandées :

La plage de dates maximale autorisée est de 12 mois pour une seule demande et les données sont disponibles à partir du 1er mai 2014.

Obtention de la liste des périodes de facturation

Pour garantir une période de facturation valide dans une requête, le client doit d’abord obtenir une liste des périodes de facturation disponibles par abonnement en utilisant l’API suivante

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods?api-version=2017-04-24-preview

Grâce à cette liste, le client peut choisir une période de facturation spécifique pour obtenir des données de consommation.

Données sur les arrivées tardives

Pour s’adapter aux services tiers présentant des délais dans la déclaration de l’utilisation, la date d’utilisation déclarée est fixée au moment où les données d’utilisation ont été envoyées, par opposition au moment où l’utilisation a eu lieu, c’est-à-dire au moment de la consommation.

En conséquence, l’utilisation est évaluée et appliquée à l’heure déclarée. Pour représenter le temps réel de consommation, les propriétés. Le champ Propriétés additionnelles contiendra désormais deux autres propriétés. ConsumptionBeginTime et ConsumptionEndTime sont les nouveaux champs qui correspondent à la fenêtre de temps de consommation réelle.

Ces changements entraînent quelques scénarios à prendre en compte lors de l’appel de l’API des détails d’utilisation :

1. Rapport de fin de mois : Pour une utilisation survenue pendant un mois mais rapportée au mois suivant, les clients doivent consulter le champ additionalProperties pour assigner l’utilisation au mois approprié.

2. Détails d’utilisation de la requête : Lorsque vous interrogez l’API des détails d’utilisation par plage de dates, la requête ne s’applique qu’à la date du rapport d’utilisation et non au temps de consommation dans le champ Propriétés additionales . Pour les clients souhaitant associer les détails de consommation aux factures, cette mise à jour n’affecte pas le processus car la facture traite l’utilisation en fonction de la date de rapport d’utilisation. Pour les clients souhaitant associer les détails d’utilisation à une date/mois spécifique au calendrier, cette mise à jour constitue un changement radical et, dans ces cas, la date du rapport d’utilisation ne peut pas être utilisée et la date d’utilisation doit être utilisée dans la section Propriétés additionnelles .

Exemple d’appel pour plus de détails :

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/usageDetails?api-version=2018-03-31&$expand=properties/additionalProperties

Exemple d’extrait de réponse :

  "properties": {
    "billingPeriodId":"/subscriptions/{subscriptionid}/providers/Microsoft.Billing/billingPeriods/20180501",
    "usageStart":"2018-05-01T00:00:00.0000000Z",
    "usageEnd":"2018-05-01T23:59:59.0000000Z",
    "instanceId":"/subscriptions/{subscriptionid}/resourceGroups/{resourcegroup}/providers/Microsoft.Cdn/profiles/{profile}",
    "instanceName":"{id}",
    "instanceLocation":"SouthCentralUS",
    "meterId":"6b88ada0-cbc0-4874-be0e-23004f8b4de7",
    "usageQuantity":0.002065,
    "pretaxCost":0,
    "currency":"USD",
    "additionalProperties": {
      "Provider": "1",
      "ConsumptionBeginTime": "2018-05-01T19:00:00",
      "ConsumptionEndTime": "2018-05-01T20:00:00"
    }
  }

Voir aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des SDK spécifiques à la langue, consultez la page suivante

Kit de développement logiciel (SDK) Python pour la consommation Azure

Azure Consumption CLI

Kit de développement logiciel (SDK) NodeJS de consommation Azure

Kit de développement logiciel (SDK) Ruby Consumption Azure