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. Actuellement, les API prennent uniquement en charge 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 Entreprise uniquement
    • Price sheet
    • Budgets
    • Prévisions
    • Balances
    • Étiquettes
    • Balises de coût
  • Clients Entreprise en Web Direct
    • Reservation Details
    • Reservation Summaries
    • Marketplace Charges
    • Usage Details
    • Reservation Recommendations

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)

Groupes d’opérations REST

Groupe d’opérations Description
Budgets Fournit des opérations pour définir, mettre à jour et supprimer des budgets dans une étendue d’abonnement ou de groupe de ressources. Prend en charge les budgets de coûts et d’utilisation.
Grille tarifaire Fournit des opérations pour obtenir la grille tarifaire pour les abonnements Entreprise.
Marketplace Charges Fournit des opérations pour obtenir des informations d’utilisation pour les ressources de la Place de marché sur les comptes d’abonnement ou de facturation d’entreprise.
Usage Details Fournit des opérations pour obtenir des informations d’utilisation sur les comptes d’abonnement ou de facturation d’entreprise.
Reservation Details Fournit des opérations pour obtenir l’utilisation détaillée de la réservation pour le paiement à l’utilisation et les abonnements Entreprise.
Rapport sur les détails de la réservation Fournit des opérations permettant d’obtenir une utilisation détaillée de la réservation pour le paiement à l’utilisation et les abonnements Entreprise dans un format de rapport optimisé pour les grandes tailles de données.
Reservation Summaries Fournit des opérations pour obtenir le récapitulatif de l’utilisation des réservations pour le paiement à l’utilisation et les abonnements Entreprise.
Recommandations de réservation Fournit des opérations pour obtenir des recommandations de réservation pour le paiement à l’utilisation et les abonnements Entreprise.
Prévisions Fournit des opérations pour obtenir des prévisions d’utilisation pour les abonnements Entreprise.
Balances Fournit des opérations pour obtenir des soldes et des résumés pour les comptes de facturation d’entreprise.
Balises Fournit des opérations pour obtenir des informations sur les étiquettes pour les abonnements Entreprise.

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

Les détails de l’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 dans la demande.

Période de facturation présente dans la demande Date de début présente dans la demande Date de fin présente dans la demande Comportement API
non non non Les données de la période de facturation actuelle sont retournées en réponse
non Oui non Les données de la période de facturation actuelle sont retournées en réponse
non non Oui Les données de la période de facturation actuelle sont retournées en réponse
non Oui Oui Les données pour les dates de début et de fin spécifiées sont retournées en réponse
Oui non non Les données pour la période de facturation spécifiée sont retournées en réponse
Oui Oui non Les données pour la période de facturation spécifiée sont retournées en réponse
Oui non Oui Les données pour la période de facturation spécifiée sont retournées en réponse
Oui Oui Oui Les données pour les dates de début et de fin spécifiées sont retournées en réponse, la période de facturation fournie est ignorée

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

Obtention de la liste des périodes de facturation

Pour fournir une période de facturation valide dans la demande, le client doit d’abord obtenir une liste des périodes de facturation disponibles par abonnement, à l’aide de l’API suivante

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

À l’aide de cette liste, le client peut choisir une période de facturation spécifique pour obtenir des données de consommation.

Données arrivant en retard

Pour prendre en charge les services tiers, qui ont des retards dans la déclaration de l’utilisation, la date d’utilisation signalée est définie sur l’heure à laquelle les données d’utilisation ont été envoyées, par opposition au moment où l’utilisation réelle a eu lieu, c’est-à-dire à l’heure de consommation.

Par conséquent, l’utilisation sera évaluée pour et appliquée à l’heure signalée. Pour représenter le temps de consommation réel, les propriétés. Le champ AdditionalProperties contient désormais deux propriétés supplémentaires. ConsumptionBeginTime et ConsumptionEndTime sont les nouveaux champs qui correspondent à la fenêtre de temps de consommation réelle.

Ces modifications entraîneront quelques scénarios qui devront être pris en compte lors de l’appel de l’API des détails de l’utilisation :

  1. Rapports de fin de mois : pour une utilisation qui s’est produite au cours d’un mois, mais signalée au cours du mois suivant, les clients devront examiner le champ AdditionalProperties pour affecter l’utilisation au mois approprié.

  2. Détails de l’utilisation de la requête : lors de l’interrogation de l’API détails de l’utilisation par une plage de dates, la requête s’applique uniquement à la date du rapport d’utilisation et non à l’heure de consommation dans le champ additionalProperties . Pour les clients qui cherchent à mapper les détails de l’utilisation aux factures, cette mise à jour n’affecte pas le processus, car la facture traite l’utilisation en fonction de la date du rapport d’utilisation. Pour les clients, qui cherchent à mapper les détails de l’utilisation à une date/mois de calendrier spécifique, cette mise à jour est un changement cassant et, dans ces scénarios, la date du rapport d’utilisation ne peut pas être utilisée et la date à laquelle l’utilisation s’est produite, dans la section AdditionalProperties , doit être utilisée.

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 au langage, consultez les pages suivantes

Kit de développement logiciel (SDK) Python d’Azure Consumption

Interface CLI d’Azure Consumption

Kit de développement logiciel (SDK) NodeJS d’Azure Consumption

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