Partager via


Migrer depuis l’API Résumé de l’utilisation de l’instance réservée EA

Les clients EA qui utilisaient précédemment l’API Enterprise Reporting consumption.azure.com pour obtenir des résumés d’utilisation d’instances réservées doivent migrer vers une API Azure Resource Manager par parité. 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 Résumé de l’utilisation de l’instance réservée

Utilisez les URI de requête suivants pour appeler la nouvelle API des récapitulatifs de la réservation.

Requêtes prises en charge

Appelez l’API avec les étendues suivantes :

  • Inscription : providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Obtenir le récapitulatif de la réservation quotidiennement

https://management.azure.com/{scope}/Microsoft.Consumption/reservationSummaries?grain=daily&$filter=properties/usageDate ge 2017-10-01 AND properties/usageDate le 2017-11-20&api-version=2023-05-01 

Obtenir le récapitulatif de la réservation mensuellement

https://management.azure.com/{scope}/Microsoft.Consumption/reservationSummaries?grain=daily&$filter=properties/usageDate ge 2017-10-01 AND properties/usageDate le 2017-11-20&api-version=2023-05-01 

Modifications du corps de la réponse

Ancienne réponse :

[
     {
        "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "skuName": "Standard_F1s",
        "reservedHours": 24,
        "usageDate": "2018-05-01T00:00:00",
        "usedHours": 23,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 95.83,
        "maxUtilizationPercentage": 100
    }
]

Nouvelle réponse  :

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.Consumption/reservationSummaries/reservationSummaries_Id1",
      "name": "reservationSummaries_Id1",
      "type": "Microsoft.Consumption/reservationSummaries",
      "tags": null,
      "properties": {
        "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "skuName": "Standard_B1s",
        "reservedHours": 720,
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0
      }
    }
  ]
}