Migrer depuis l’API Détails de l’utilisation des instances réservées EA

Les clients EA qui utilisaient précédemment l’API Enterprise Reporting consumption.azure.com pour obtenir les détails d’utilisation des 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.

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 plus d’informations, consultez Attribuer des autorisations aux API Cost Management.

Appeler l’API des détails d’utilisation des instances réservées

Microsoft ne met pas à jour les anciennes API Détails des réservations synchrones. Nous vous conseillons de passer au modèle plus récent d’appel d’API asynchrone qui est pris en charge par SPN, dans le cadre de la migration. Les requêtes asynchrones permettent de mieux gérer les grandes quantités de données, et elles réduisent les erreurs de délai d’attente.

Requêtes prises en charge

Utilisez les URI de requête suivants lors de l’appel de la nouvelle API des détails de la réservation asynchrone. Votre numéro d’inscription doit être utilisé en tant que billingAccountId. Vous pouvez appeler l’API avec l’étendue suivante :

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

Générer un rapport par ID de compte de facturation

Exemple de requête pour générer un rapport sur les détails de la réservation

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2023-11-01 

La requête POST retourne un emplacement pour interroger l’état de génération de rapport comme indiqué dans la réponse suivante :

Exemple de réponse

Code d’état 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?api-version=2023-11-01
Retry-After: 60

Code d’état 200

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Exemple de requête pour interroger l’état de création du rapport

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/reservationDetailsOperationResults/{operationId}?api-version=2023-11-01 

Exemple de réponse d’interrogation

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Modifications du corps de la réponse

Les informations suivantes sont un exemple de réponse de l’API détails de réservation synchrone plus ancienne.

Ancienne réponse :

{
    "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
    "usageDate": "2018-02-01T00:00:00",
    "skuName": "Standard_F2s",
    "instanceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/resourvegroup1/providers/microsoft.compute/virtualmachines/VM1",
    "totalReservedQuantity": 18.000000000000000,
    "reservedHours": 432.000000000000000,
    "usedHours": 400.000000000000000
}

Nouvelle réponse  :

La nouvelle API crée un fichier CSV pour vous. Voyez les champs de fichier suivants.

Contenu connexe

• Lisez l’article Vue d’ensemble de Migrer des rapports EA aux API ARM.