Condividi tramite

Eseguire la migrazione dall'API di riepilogo dell'utilizzo istanze riservate EA

  • Articolo

I clienti EA che in precedenza usavano l'API di creazione di report Enterprise consumption.azure.com per ottenere riepilogo dell'utilizzo di 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.

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 l'API di riepilogo dell'utilizzo istanze riservate

Usare gli URI di richieste seguenti per chiamare la nuova API di riepilogo delle prenotazioni.

Richieste supportate

È possibile chiamare l'API usando gli ambiti seguenti:

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

Ottenere il riepilogo giornaliero delle prenotazioni

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 mensile delle prenotazioni

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 del corpo della risposta

Vecchia risposta:

[
     {
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "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": "00000000-0000-0000-0000-000000000000",
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "skuName": "Standard_B1s",
        "reservedHours": 720,
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0
      }
    }
  ]
}

Contenuto correlato