Condividi tramite

Eseguire la migrazione dall'API Raccomandazioni sulle istanze riservate EA

  • Articolo

I clienti EA che in precedenza usavano l'API di creazione di report Enterprise consumption.azure.com per ottenere raccomandazioni sulle istanze riservate devono eseguire la migrazione a un'API di Azure Resource Manager con pari funzionalità. Le istruzioni seguenti consentono di eseguire la migrazione e descrivere eventuali differenze di contratto tra l'API precedente e la nuova API.

Nota

Tutte le API di creazione report enterprise di Azure vengono ritirati. È consigliabile eseguire la migrazione alle API di Gestione costi Microsoft il prima possibile.

Assegnare autorizzazioni a un'entità servizio per chiamare l'API

Prima di chiamare l'API, è necessario configurare un'entità servizio con l'autorizzazione corretta. L'entità servizio viene utilizzata per chiamare l'API. Per altre informazioni, vedere Assegnare autorizzazioni alle API di Gestione costi.

Chiamare le API per accomandazioni sulle istanze riservate

Usare gli URI di richieste seguenti per chiamare la nuova API di raccomandazioni per le prenotazioni.

Richieste supportate

È possibile chiamare l'API usando gli ambiti seguenti:

  • Registrazione: providers/Microsoft.Billing/billingAccounts/{billingAccountId}
  • Sottoscrizione: subscriptions/{subscriptionId}
  • Gruppi di risorse: subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}

Ottenere raccomandazioni

Tramite questa API sono disponibili sia le raccomandazioni per ambito singolo che per ambiti condivisi. È anche possibile filtrare in base all'ambito come parametro facoltativo dell'API.

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

Modifiche del corpo della risposta

Nella nuova API le raccomandazioni per gli ambiti condivisi e singoli vengono combinate in un'UNICA API.

Risposta precedente per Ambito condiviso:

{
        "lookBackPeriod": "Last60Days",
        "meterId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "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"
          }
        ]
    },

Risposta precedente per ambito singolo:

{
      "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "lookBackPeriod": "Last60Days",
      "meterId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "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"
        }
      ]
}

Nuova risposta:

{
  "value": [
    {
      "id": "billingAccount/123456/providers/Microsoft.Consumption/reservationRecommendations/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "name": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "type": "Microsoft.Consumption/reservationRecommendations",
      "location": "westus",
      "sku": "Standard_DS1_v2",
      "kind": "legacy",
      "properties": {
        "meterId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "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"
          }
        ]
      }
    },
   ]
}

Contenuto correlato