Migrare dall'API di riepilogo dell'utilizzo delle istanze riservate di EA

I clienti EA che in precedenza usavano l'API Enterprise Reporting consumption.azure.com per ottenere i riepiloghi di utilizzo delle istanze riservate devono eseguire la migrazione a un'API di Azure Resource Manager di parità. Le istruzioni seguenti consentono di eseguire la migrazione e discutere le differenze di contratto tra l'API precedente e la nuova API.

Assegnare autorizzazioni a un principale del servizio per chiamare l'API

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

Chiamare l'API di riepilogo dell'utilizzo delle istanze riservate

Usare gli URI di richiesta seguenti per chiamare la nuova API Riepiloghi delle prenotazioni.

Richieste supportate

Chiamare l'API con gli ambiti seguenti:

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

Ottenere il riepilogo delle prenotazioni ogni giorno

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 

Ottenere il riepilogo delle prenotazioni mensilmente

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 

Modifiche al corpo della risposta

Risposta precedente:

[
     {
        "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
    }
]

Nuova risposta:

{
  "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
      }
    }
  ]
}

Contenuti correlati

• Leggere l'articolo Panoramica sulla migrazione dall'API di creazione report EA ad ARM.