Share via

Migrer à partir d’une API de suggestions relatives à l’instance réservée EA

  • Article

Les clients EA qui utilisaient précédemment l’API Enterprise Reporting consumption.azure.com pour obtenir des suggestions relatives à l’instance réservée doivent migrer vers une API Azure Resource Manager par parité. Les instructions suivantes vous aident à migrer et à décrire les 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 principe 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 de suggestions relatives à l’instance réservée

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

Requêtes prises en charge

Appelez l’API avec les étendues suivantes :

  • Inscription : providers/Microsoft.Billing/billingAccounts/{billingAccountId}
  • Abonnement : subscriptions/{subscriptionId}
  • Groupes de ressources : subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}

Obtenir des recommandations

La recommandation relative à l’étendue partagée et celle se rapportant à l’étendue unique sont disponibles par l’intermédiaire de cette API. Vous pouvez également filtrer sur l’étendue sous la forme d’un paramètre d’API facultatif.

https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/reservationRecommendations?api-version=2023-05-01

Modifications du corps de la réponse

Dans la nouvelle API, les suggestions pour les étendues partagées et uniques sont combinées en une seule API.

Ancienne réponse pour l’étendue partagée :

{
        "lookBackPeriod": "Last60Days",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "skuName": "Standard_B1s",
        "term": "P3Y",
        "region": "eastus",
        "costWithNoRI": 39.773316464000011,
        "recommendedQuantity": 2,
        "totalCostWithRI": 22.502541385887369,
        "netSavings": 17.270775078112642,
        "firstUsageDate": "2024-02-23T00:00:00",
        "resourceType": "virtualmachines",
        "instanceFlexibilityRatio": 2.0,
        "instanceFlexibilityGroup": "BS Series",
        "normalizedSize": "Standard_B1ls",
        "recommendedQuantityNormalized": 4.0,
        "skuProperties": [
          {
            "name": "Cores",
            "value": "1"
          },
          {
            "name": "Ram",
            "value": "1"
          }
        ]
    },

Ancienne réponse pour l’étendue unique :

{
      "subscriptionId": "00000000-0000-0000-0000-000000000000",
      "lookBackPeriod": "Last60Days",
      "meterId": "00000000-0000-0000-0000-000000000000",
      "skuName": "Standard_B1s",
      "term": "P3Y",
      "region": "eastus",
      "costWithNoRI": 19.892601567999996,
      "recommendedQuantity": 1,
      "totalCostWithRI": 11.252968788943683,
      "netSavings": 8.6396327790563134,
      "firstUsageDate": "2024-02-23T00:00:00",
      "resourceType": "virtualmachines",
      "instanceFlexibilityRatio": 2.0,
      "instanceFlexibilityGroup": "BS Series",
      "normalizedSize": "Standard_B1ls",
      "recommendedQuantityNormalized": 2.0,
      "skuProperties": [
        {
          "name": "Cores",
          "value": "1"
        },
        {
          "name": "Ram",
          "value": "1"
        }
      ]
}

Nouvelle réponse  :

{
  "value": [
    {
      "id": "billingAccount/123456/providers/Microsoft.Consumption/reservationRecommendations/00000000-0000-0000-0000-000000000000",
      "name": "00000000-0000-0000-0000-000000000000",
      "type": "Microsoft.Consumption/reservationRecommendations",
      "location": "westus",
      "sku": "Standard_DS1_v2",
      "kind": "legacy",
      "properties": {
        "meterId": "00000000-0000-0000-0000-000000000000",
        "term": "P1Y",
        "costWithNoReservedInstances": 12.0785105,
        "recommendedQuantity": 1,
        "totalCostWithReservedInstances": 11.4899644807748,
        "netSavings": 0.588546019225182,
        "firstUsageDate": "2019-07-07T00:00:00-07:00",
        "scope": "Shared",
        "lookBackPeriod": "Last7Days",
        "instanceFlexibilityRatio": 1,
        "instanceFlexibilityGroup": "DSv2 Series",
        "normalizedSize": "Standard_DS1_v2",
        "recommendedQuantityNormalized": 1,
        "skuProperties": [
          {
            "name": "Cores",
            "value": "1"
          },
          {
            "name": "Ram",
            "value": "1"
          }
        ]
      }
    },
   ]
}

Contenu connexe