Condividi tramite

Eseguire la migrazione dall'API Dettagli di utilizzo istanze riservate EA

  • Articolo

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

Microsoft non aggiorna le API dei dettagli delle prenotazioni sincrone meno recenti. È consigliabile passare al nuovo modello di chiamata API asincrona supportato da SPN come parte della migrazione. Le richieste asincrone gestiscono in modo più efficace grandi quantità di dati e riducono gli errori di timeout.

Richieste supportate

Usare gli URI di richieste seguenti per chiamare le nuove API di dettagli delle prenotazioni asincrone. Per billingAccountID è necessario usare il proprio numero di registrazione. È possibile chiamare l'API con l'ambito seguente:

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

Generare report in base all'ID dell'account di fatturazione

Richiesta di esempio per generare un report di dettagli delle prenotazioni

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2023-11-01

La richiesta POST restituisce un percorso per eseguire il polling dello stato di generazione del report come descritto nella risposta seguente:

Risposta di esempio

Codice di stato 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

Codice di stato 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"
  }
}

Richiesta di esempio per eseguire il polling sullo stato di generazione dei report

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/reservationDetailsOperationResults/{operationId}?api-version=2023-11-01

Risposta del polling di esempio

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

Modifiche del corpo della risposta

Le informazioni seguenti sono un esempio della risposta dell'API dettagli prenotazione sincrona precedente.

Vecchia risposta:

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

Nuova risposta:

La nuova API crea automaticamente un file CSV. Vedere i campi del file seguenti.

Vecchia proprietà Nuova proprietà Note
InstanceFlexibilityGroup Nuova proprietà di flessibilità delle dimensioni dell'istanza.
InstanceFlexibilityRatio Nuova proprietà di flessibilità delle dimensioni dell'istanza.
instanceId InstanceName
Tipologia Nuova proprietà. Il valore è None, Reservation o IncludedQuantity.
reservationId ReservationId
reservationOrderId ReservationOrderId
reservedHours ReservedHours
skuName SkuName
totalReservedQuantity TotalReservedQuantity
usageDate UsageDate
usedHours UsedHours

Contenuto correlato