Partager via


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.

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 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.

Ancienne propriété Nouvelle propriété Notes
InstanceFlexibilityGroup Nouvelle propriété de flexibilité de taille d’instance.
InstanceFlexibilityRatio Nouvelle propriété de flexibilité de taille d’instance.
instanceId InstanceName
Kind C’est une nouvelle propriété. La valeur est None, Reservation ou IncludedQuantity.
reservationId ID de réservation
reservationOrderId ReservationOrderId
reservedHours ReservedHours
skuName skuName
totalReservedQuantity TotalReservedQuantity
usageDate UsageDate
usedHours UsedHours