Share via

Migrer à partir de l’API du récapitulatif du solde EA

  • Article

Les clients EA qui utilisaient précédemment l’API Enterprise Reporting consumption.azure.com pour obtenir leur récapitulatif du solde doivent migrer vers une API Azure Resource Manager de remplacement. Les instructions suivantes vous aident à migrer et à discuter des différences de contrat entre l’ancienne API et la nouvelle API.

Remarque

Toutes les API de création de rapports Azure Enterprise sont mises hors service. Vous devriez effectuer la migration vers les API Microsoft Cost Management dès que possible.

Attribuer des autorisations à un principal de service pour appeler l’API

Avant d’appeler l’API, vous devez configurer un principal de service avec l’autorisation correcte. Vous utilisez le principal de service pour appeler l’API. Pour obtenir plus d’informations, consultez Attribuer des autorisations aux API Cost Management.

Appeler l’API du récapitulatif de solde

Utilisez les URI de requête suivants lors de l’appel de la nouvelle API de récapitulatif du solde. Votre numéro d’inscription doit être utilisé en tant que billingAccountId.

Requêtes prises en charge

Obtenir l’inscription

https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/balances?api-version=2023-05-01

Modifications du corps de la réponse

Ancien corps de la réponse :

{
  "id": "enrollments/100/billingperiods/201507/balancesummaries",
  "billingPeriodId": 201507,
  "currencyCode": "USD",
  "beginningBalance": 0,
  "endingBalance": 1.1,
  "newPurchases": 1,
  "adjustments": 1.1,
  "utilized": 1.1,
  "serviceOverage": 1,
  "chargesBilledSeparately": 1,
  "totalOverage": 1,
  "totalUsage": 1.1,
  "azureMarketplaceServiceCharges": 1,
  "newPurchasesDetails": [
    {
      "name": "",
      "value": 1
    }
  ],
  "adjustmentDetails": [
    {
      "name": "Promo Credit",
      "value": 1.1
    },
    {
      "name": "SIE Credit",
      "value": 1
    }
  ]
}

Nouveau corps de la réponse :

Les mêmes données sont désormais disponibles dans le champ des propriétés de la réponse de la nouvelle API. Des modifications mineures de l’orthographe de certains noms de champs sont possibles.

{
  "id": "/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/balances/balanceId1",
  "name": "balanceId1",
  "type": "Microsoft.Consumption/balances",
  "properties": {
    "currency": "USD  ",
    "beginningBalance": 3396469.19,
    "endingBalance": 2922371.02,
    "newPurchases": 0,
    "adjustments": 0,
    "utilized": 474098.17,
    "serviceOverage": 0,
    "chargesBilledSeparately": 0,
    "totalOverage": 0,
    "totalUsage": 474098.17,
    "azureMarketplaceServiceCharges": 609.82,
    "billingFrequency": "Month",
    "priceHidden": false,
    "overageRefund": 2012.61,
    "newPurchasesDetails": [
      {
        "name": "Promo Purchase",
        "value": 1
      }
    ],
    "adjustmentDetails": [
      {
        "name": "Promo Credit",
        "value": 1.1
      },
      {
        "name": "SIE Credit",
        "value": 1
      }
    ]
  }
}

Contenu connexe