Consommation Azure

Article
02/07/2024

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)

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 traités lors de l’appel de l’API des détails d’utilisation :

Rapports de fin de mois : pour l’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é.
Détails de l’utilisation de la requête : lors de l’interrogation de l’API détails d’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 souhaitent mapper les détails d’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/un mois de calendrier spécifique, cette mise à jour est un changement cassant. Pour 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 obtenir des détails supplémentaires :

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

Exemple d’extrait de code 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 kits SDK spécifiques au langage, consultez les rubriques 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