Partager via

Passer en revue la facturation d’un abonnement avec les API REST

Les API de création de rapports Azure vous aident à passer en revue et à gérer vos coûts Azure.

Des filtres permettent de personnaliser les résultats en fonction de vos besoins.

Vous pouvez découvrir ici comment utiliser les API REST pour retourner les détails de facturation d’un abonnement sur une plage de dates donnée.

GET https://management.azure.com/subscriptions/${subscriptionID}/providers/Microsoft.Billing/billingPeriods/${billingPeriod}/providers/Microsoft.Consumption/usageDetails?$filter=properties/usageEnd ge '${startDate}' AND properties/usageEnd le '${endDate}'
Content-Type: application/json
Authorization: Bearer

Générer la demande

Le paramètre {subscriptionID} est obligatoire et identifie l’abonnement cible.

Le paramètre {billingPeriod} est obligatoire et spécifie une période de facturation active. Le paramètre billingPeriod doit être mis en forme sans tirets. Par exemple : 202112. Si un jour du mois est ajouté à billingPeriod, il est ignoré.

Les paramètres ${startDate} et ${endDate} sont obligatoires pour cet exemple, mais facultatifs pour le point de terminaison. Ils spécifient la plage de dates sous forme de chaînes, au format AAAA-MM-JJ. Par exemple, 2018-05-01 et 2018-06-15. Des tirets sont requis pour startDate et endDate.

Les en-têtes suivants sont requis :

En-tête de requête Description
Content-Type : Obligatoire. Défini sur application/json.
Authorization : Obligatoire. Défini sur un jeton d’accèsBearer valide.

response

Le code d’état 200 (OK) est retourné pour une réponse correcte, qui contient une liste de coûts détaillés pour votre compte.

{
  "value": [
    {
      "id": "/subscriptions/{$subscriptionID}/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/usageDetails/{$detailsID}",
      "name": "{$detailsID}",
      "type": "Microsoft.Consumption/usageDetails",
      "properties": {
        "billingPeriodId": "/subscriptions/${subscriptionID}/providers/Microsoft.Billing/billingPeriods/${billingPeriod}",
        "invoiceId": "/subscriptions/${subscriptionID}/providers/Microsoft.Billing/invoices/${invoiceID}",
        "usageStart": "${startDate}}",
        "usageEnd": "${endDate}",
        "currency": "USD",
        "usageQuantity": "${usageQuantity}",
        "billableQuantity": "${billableQuantity}",
        "pretaxCost": "${cost}",
        "meterId": "${meterID}",
        "meterDetails": "${meterDetails}"
      }
    }
  ],
  "nextLink": "${nextLinkURL}"
}

Chaque élément de value représente une information détaillée concernant l’utilisation d’un service :

Propriété de la réponse Description
subscriptionGuid ID global unique pour l’abonnement.
startDate Date à laquelle l’utilisation a démarré.
endDate Date à laquelle l’utilisation s’est terminée.
usageQuantity Quantité utilisée.
billableQuantity Quantité réellement facturée.
pretaxCost Coût facturé, avant application des taxes.
meterDetails Informations détaillées sur l’utilisation.
nextLink Quand elle est définie, spécifie une URL pour la « page » suivante d’informations détaillées. Vide quand la page est la dernière.

Cet exemple est abrégé ; consultez Liste des détails d’utilisation pour une description complète de chaque champ de la réponse.

Les autres codes d’état indiquent les conditions d’erreur. Dans ces cas, l’objet de réponse explique pourquoi la demande a échoué.

{
  "error": [
    {
      "code": "Error type.",
      "message": "Error response describing why the operation failed."
    }
  ]
}

Étapes suivantes