Eseguire la migrazione delle API dal Contratto Enterprise al Contratto del cliente Microsoft

Questo articolo illustra le differenze della struttura dei dati, delle API e di altre integrazioni di sistema tra gli account Contratto Enterprise (EA) e Contratto del cliente Microsoft. Gestione dei costi supporta le API per entrambi i tipi di account. Prima di continuare, vedere l'articolo Configurare l'account di fatturazione per un Contratto del cliente Microsoft.

È consigliabile che le organizzazioni con un account EA esistente leggano questo articolo durante la configurazione di un account MCA. In precedenza, il rinnovo di un account EA richiedeva un minimo intervento per passare da una registrazione a una nuova. La migrazione a un account MCA, invece, richiede un'attività aggiuntiva. Il motivo è dovuto alle modifiche del sottosistema di fatturazione sottostante, che influiscono su tutte le API correlate ai costi e sulle offerte di servizi.

API MCA e integrazione

Le API MCA e la nuova integrazione consentono di:

• Avere disponibilità completa di API tramite le API native di Azure.
• Configurare più fatture in un singolo account di fatturazione.
• Accedere a un'API combinata con l'utilizzo di servizi di Azure, l'utilizzo del Marketplace di terze parti e gli acquisti nel Marketplace.
• Visualizzare i costi in vari profili di fatturazione (come per le registrazioni) tramite Gestione dei costi.
• Accedere alle nuove API per visualizzare i costi, ricevere notifiche quando i costi superano le soglie predefinite ed esportare automaticamente i dati non elaborati.

Elenco di controllo per la migrazione

Gli elementi seguenti facilitano la transizione alle API MCA.

• Acquisire familiarità con il nuovo account di fatturazione del Contratto del cliente Microsoft.
• Identificare le API in uso e verificare quali vengono sostituite nella sezione seguente.
• Acquisire familiarità con le API REST di Azure Resource Manager.
• Se non si usano già API di Azure Resource Manager, registrare l'app client con Microsoft Entra ID.
• Concedere all'applicazione creata durante la registrazione dell'app Microsoft Entra l'accesso in lettura all'account di fatturazione usando il controllo di accesso (IAM).
• Aggiornare il codice di programmazione per l'uso dell'autenticazione di Microsoft Entra.
• Aggiornare il codice di programmazione per sostituire le chiamate alle API EA con le chiamate alle API MCA.
• Aggiornare la gestione degli errori per l'uso di nuovi codici errore.
• Per altre azioni necessarie, esaminare le offerte di integrazione aggiuntive, ad esempio Power BI.

API EA sostituite con API MCA

Le API EA usano una chiave API per l'autenticazione e l'autorizzazione. Le API MCA usano l'autenticazione Microsoft Entra.

¹ I dati sull'utilizzo dei servizi di Azure e del Marketplace di terze parti sono disponibili con l'API Dettagli utilizzo.

Per gli account di fatturazione MCA sono disponibili le API seguenti:

² Le API restituiscono gli elenchi di oggetti, ovvero gli ambiti, in cui operano le esperienze di Gestione dei costi nel portale di Azure e le API. Per altre informazioni sugli ambiti di Gestione costi, vedere Informazioni e utilizzo degli ambiti.

Se si usano API EA esistenti, è necessario aggiornarle per supportare gli account di fatturazione MCA. La tabella seguente illustra altre modifiche di integrazione:

API per ottenere saldo e crediti

Il riepilogo Get Balance è stato usato per fornire un riepilogo mensile di:

• Saldi
• Nuovi acquisti
• Addebiti per il servizio Azure Marketplace
• Rettifiche
• Addebiti per eccedenza del servizio

Tutte le API a consumo vengono sostituite da API native di Azure che usano Microsoft Entra ID per l'autenticazione e l'autorizzazione. Per altre informazioni sulle chiamate alle API REST di Azure, vedere Introduzione a REST.

L'API Get Balance Summary viene sostituita dall'API Microsoft.Billing/billingAccounts/billingProfiles/availableBalance.

Per ottenere i saldi disponibili con l'API Available Balance:

API per ottenere dati su costi e utilizzo

Le API seguenti consentono di ottenere una scomposizione quotidiana dei costi derivanti dall'utilizzo di servizi di Azure, dall'utilizzo del Marketplace di terze parti e da altri acquisti nel Marketplace. Le seguenti API distinte sono state unite per i servizi di Azure e per l'utilizzo del Marketplace di terze parti. Le API precedenti vengono sostituite dall'API Esportazioni o dall'API Dettagli dei costi. Per scegliere la soluzione più adatta, vedere Scegliere una soluzione per i dettagli dei costi. Entrambe le soluzioni forniscono lo stesso file Dettagli dei costi e dispongono di acquisti nel marketplace nei dati, che in precedenza venivano visualizzati solo nel riepilogo del saldo fino a oggi.

Le API Esportazioni e Dettagli dei costi, come tutte le API di Gestione dei costi, sono disponibili in più ambiti. Per i costi fatturati, che in genere si ricevono a livello di registrazione, usare l'ambito del profilo di fatturazione. Per altre informazioni sugli ambiti di Gestione costi, vedere Informazioni e utilizzo degli ambiti.

Alcuni nomi di proprietà sono stati modificati nel nuovo set di dati Dettagli dei costi disponibile tramite le API Esportazioni e Dettagli dei costi. La tabella seguente mostra le proprietà corrispondenti.

API Billing Periods sostituite da API Invoices

Gli account di fatturazione MCA non usano i periodi di fatturazione. Usano invece le fatture per definire l'ambito dei costi in specifici periodi di fatturazione. L'API Billing Periods viene sostituita dall'API Invoices. Tutte le API a consumo vengono sostituite da API native di Azure che usano Microsoft Entra ID per l'autenticazione e l'autorizzazione. Per altre informazioni sulle chiamate alle API REST di Azure, vedere Introduzione a REST.

Per ottenere le fatture con l'API Invoices:

API Price Sheet

Questa sezione descrive le attuali API Price Sheet e fornisce raccomandazioni per il passaggio all'API Price Sheet per i Contratti del cliente Microsoft. Descrive inoltre l'API Price Sheet per i Contratti del cliente Microsoft e i campi inclusi negli elenchi prezzi. Le API Enterprise Get price sheet e Enterprise Get billing periods vengono sostituite dall'API Price Sheet per i Contratti del cliente Microsoft (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). La nuova API supporta sia i formati JSON che CSV, nei formati REST asincroni. Tutte le API a consumo vengono sostituite da API native di Azure che usano Microsoft Entra ID per l'autenticazione e l'autorizzazione. Per altre informazioni sulle chiamate alle API REST di Azure, vedere Introduzione a REST.

API Billing Enterprise

Le API Billing Enterprise si usano con le registrazioni Enterprise per ottenere informazioni su prezzi e periodi di fatturazione. L'autenticazione e l'autorizzazione vengono gestite tramite token Web di Microsoft Entra.

Per ottenere i prezzi applicabili per la registrazione Enterprise specificata con le API Price Sheet e Billing Period:

API Price Sheet per i Contratti del cliente Microsoft

Usare l'API Price Sheet per i Contratti del cliente Microsoft per visualizzare i prezzi per tutti i servizi a consumo di Azure e del Marketplace. I prezzi mostrati per il profilo di fatturazione si applicano a tutte le sottoscrizioni che include.

Usare l'API Price Sheet per visualizzare i dati sugli elenchi prezzi dei servizi a consumo di Azure in formato CSV:

Usare l'API Price Sheet per visualizzare i dati sugli elenchi prezzi dei servizi a consumo di Azure in formato JSON:

L'uso dell'API restituisce l'elenco prezzi per l'intero account. Tuttavia, è anche possibile ottenere una versione ridotta dell'elenco prezzi in formato PDF. Il riepilogo include i servizi a consumo di Azure e del Marketplace fatturato per una specifica fattura. La fattura è identificata tramite {invoiceId}, che corrisponde esattamente al numero di fattura riportato nei file PDF Riepilogo fattura. Ecco un esempio.

Per visualizzare informazioni sulla fattura con l'API Price Sheet in formato CSV:

Per visualizzare informazioni sulla fattura con l'API Price Sheet in formato JSON:

È anche possibile visualizzare i prezzi stimati per qualsiasi servizio a consumo di Azure o del Marketplace nel ciclo di fatturazione aperto corrente o nel periodo del servizio.

Per visualizzare i prezzi stimati per i servizi a consumo con l'API Price Sheet in formato CSV:

Per visualizzare i prezzi stimati per i servizi a consumo con l'API Price Sheet in formato JSON:

Le API Price Sheet per i Contratti del cliente Microsoft sono API REST asincrone. Le risposte per le API sono diverse rispetto alle API sincrone precedenti. Anche il corpo della risposta dell'API è cambiato.

Vecchio corpo della risposta

Ecco un esempio di risposta dell'API REST sincrona:

[
        {
            "id": "enrollments/573549891/billingperiods/2016011/products/343/pricesheets",
            "billingPeriodId": "201704",
            "meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
            "meterName": "A1 VM",
            "unitOfMeasure": "100 Hours",
            "includedQuantity": 0,
            "partNumber": "N7H-00015",
            "unitPrice": 0.00,
            "currencyCode": "USD"
        },
        {
    ]

Nuovo corpo della risposta

Le API supportano il formato Azure REST asincrono. Chiamare l'API usando GET per ricevere la risposta seguente:

No Response Body

HTTP Status 202 Accepted

Le intestazioni seguenti vengono inviate con la posizione dell'output:

Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Azure-AsyncOperation:https://managment.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Retry-After: 10

OData-EntityId: {operationId}

Effettuare un'altra chiamata GET per la posizione. La risposta alla chiamata GET è la stessa finché l'operazione non raggiunge uno stato di completamento o di errore. Al termine, la risposta alla chiamata GET per la posizione restituisce l'URL di download, come se l'operazione venisse eseguita contemporaneamente. Ecco un esempio:

HTTP Status 200

{
  "id": "providers/Microsoft.Consumption/operationresults/{operationId}",
  "name": {operationId},
  "type": “Microsoft.Consumption/operationResults",
  "properties" : {
    "downloadUrl": {urltoblob},
    "validTill": "Date"
  }
}

Anche il client può effettuare una chiamata GET per Azure-AsyncOperation. L'endpoint restituisce lo stato dell'operazione.

La tabella seguente illustra i campi dell'API Enterprise Get price sheet precedente. Include i campi corrispondenti del nuovo elenco prezzi per i Contratti del cliente Microsoft:

Operazioni dell'API Consumption Price Sheet

Per i Contratti Enterprise si usano le operazioni Get e Get By Billing Period dell'API Consumption Price Sheet per un ambito in base a subscriptionId o a periodo di fatturazione. L'API usa l'autenticazione di Azure Resource Management.

Per ottenere informazioni sull'elenco prezzi per un ambito con l'API Price Sheet:

Per ottenere informazioni sull'elenco prezzi in base a periodo di fatturazione con l'API Price Sheet:

Invece degli endpoint API precedenti, usare quelli seguenti per i Contratti del cliente Microsoft:

API Price Sheet per i Contratti del cliente Microsoft (API REST asincrone)

Questa API è destinata ai Contratti del cliente Microsoft e prevede attributi aggiuntivi.

Elenco prezzi per un ambito del profilo di fatturazione in un account di fatturazione

Questa è l'API esistente. È stata aggiornata per fornire l'elenco prezzi per un profilo di fatturazione in un account di fatturazione.

Elenco prezzi per un ambito in base ad account di fatturazione

L'autenticazione di Azure Resource Manager si usa quando si ottiene l'elenco prezzi nell'ambito di registrazione in un account di fatturazione.

Per ottenere l'elenco prezzi a livello di account di registrazione in un account di fatturazione:

Per un Contratto del cliente Microsoft, usare le informazioni della sezione seguente. Fornisce le proprietà dei campi usati per i Contratti del cliente Microsoft.

Elenco prezzi per un ambito del profilo di fatturazione in un account di fatturazione

L'API aggiornata in base ad account di fatturazione ottiene l'elenco prezzi in formato CSV. Per ottenere l'elenco prezzi nell'ambito del profilo di fatturazione per un contratto MCA:

Nell'ambito di registrazione del contratto EA, la risposta e le proprietà dell'API sono identiche. Le proprietà corrispondono alle stesse proprietà di MCA.

Le proprietà precedenti per le API Price Sheet di Azure Resource Manager e le nuove proprietà corrispondenti sono indicate nella tabella seguente.

Il prezzo per i Contratti con i clienti Microsoft è definito in modo diverso rispetto ai Contratti Enterprise. Il prezzo per i servizi nella registrazione Enterprise è univoco per prodotto, numero parte, contatore e offerta. Il numero parte non viene usato nei Contratti con i clienti Microsoft.

Il prezzo dei servizi a consumo di Azure che fanno parte di un Contratto del cliente Microsoft è univoco per productOrderName e meterID, che rappresentano il contatore del servizio e il piano del prodotto.

Per riconciliare tra l'elenco prezzi e l'utilizzo nell'API Usage Details, è possibile usare productOrderName e meterID.

Gli utenti con diritti di proprietario, collaboratore, lettore e gestione fatture nel profilo di fatturazione possono scaricare l'elenco prezzi.

L'elenco prezzi riguarda i servizi il cui prezzo è basato sull'utilizzo. I servizi includono quelli a consumo di Azure e a consumo del Marketplace. L'ultimo prezzo alla fine di ogni periodo di servizio è bloccato e viene applicato all'utilizzo in un singolo periodo di servizio. Per i servizi a consumo di Azure, il periodo di servizio è in genere un mese di calendario.

Campi ritirati dell'API Price Sheet

I campi seguenti non sono disponibili nelle API Price Sheet del Contratto del cliente Microsoft oppure sono uguali.

API Reservation Instance Charge sostituita

Con l'API Reserved Instance Charge, è possibile ottenere le transazioni di fatturazione per gli acquisti di prenotazioni. La nuova API include tutti gli acquisti, incluse le offerte del Marketplace di terze parti. Tutte le API a consumo vengono sostituite da API native di Azure che usano Microsoft Entra ID per l'autenticazione e l'autorizzazione. Per altre informazioni sulle chiamate alle API REST di Azure, vedere Introduzione a REST. L'API Reserved Instance Charge viene sostituita dall'API Transaction.

Per ottenere le transazioni di acquisto di prenotazioni con l'API Transactions:

API Recommendations sostituita

Le API Reserved Instance Purchase Recommendations forniscono dati di utilizzo delle macchine virtuali relativi agli ultimi 7, 30 o 60 giorni. Le API forniscono anche raccomandazioni per l'acquisto di prenotazioni. che includono:

• API Shared Reserved Instance Recommendation
• API Single Reserved Instance Recommendations

Tutte le API a consumo vengono sostituite da API native di Azure che usano Microsoft Entra ID per l'autenticazione e l'autorizzazione. Per altre informazioni sulle chiamate alle API REST di Azure, vedere Introduzione a REST. Le API di raccomandazioni sulle prenotazioni elencate sopra vengono sostituite dall'API Microsoft.Consumption/reservationRecommendations.

Per ottenere raccomandazioni sulle prenotazioni con l'API Reservation Recommendations:

API Reservation Usage sostituite

Con l'API Reserved Instance Usage, è possibile ottenere dati di utilizzo delle prenotazioni in una registrazione. Se una registrazione include più di un'istanza riservata, con questa API è anche possibile ottenere dati di utilizzo di tutte le istanze riservate acquistate.

che includono:

• Dettagli sull'utilizzo di istanze riservate
• Riepilogo dell'utilizzo di istanze riservate

Tutte le API a consumo vengono sostituite da API native di Azure che usano Microsoft Entra ID per l'autenticazione e l'autorizzazione. Per altre informazioni sulle chiamate alle API REST di Azure, vedere Introduzione a REST. Le API di raccomandazioni sulle prenotazioni elencate sopra vengono sostituite dalle API Microsoft.Consumption/reservationDetails e Microsoft.Consumption/reservationSummaries.

Per ottenere i dettagli delle prenotazioni con l'API Reservation Details:

Per ottenere i dettagli delle prenotazioni con l'API Reservation Summaries:

Integrazione di Power BI

Per la creazione di report sui costi, è anche possibile usare Power BI. Il connettore Gestione dei costi per Power BI Desktop può essere usato per creare report avanzati e personalizzati che consentono di comprendere meglio la spesa di Azure. Il connettore Gestione dei costi attualmente supporta i clienti con Contratto del cliente Microsoft o Contratto Enterprise.

Contenuto correlato

• Per informazioni su come monitorare e controllare la spesa di Azure, vedere Documentazione di Gestione costi. Oppure se si vuole ottimizzare l'uso delle risorse con gestione costi.