Panoramica su come eseguire la migrazione da Azure Enterprise Reporting alle API di Gestione dei costi Microsoft

Questo articolo informa gli sviluppatori che hanno creato soluzioni personalizzate usando le API di Creazione report aziendali di Azure su modifiche importanti. Le nuove API di Gestione dei costi Microsoft offrono ora funzionalità avanzate e supporto per le entità servizio, rendendole una scelta più affidabile per i progetti.

Punti principali:

• Migrazione consigliata: è consigliabile valutare la possibilità di eseguire la migrazione delle soluzioni personalizzate alle API di Gestione dei costi Microsoft. Sono attivamente in fase di sviluppo e offrono funzionalità migliorate.
• Data di ritiro: tutte le API di creazione report di Azure Enterprise vengono ritirate.

Questo articolo include:

• Panoramica delle differenze tra API di Creazione report aziendali di Azure e API di Gestione dei costi Microsoft.
• Indicazioni su cosa aspettarsi durante la migrazione alle API di Gestione dei costi Microsoft.
• Informazioni dettagliate sulle nuove funzionalità disponibili con le API di Gestione dei costi Microsoft.

Invito all'azione:

• Per garantire una transizione uniforme, è consigliabile iniziare a pianificare la migrazione alle API di Gestione dei costi Microsoft ben prima della data di ritiro.

Differenze tra le API

Le informazioni seguenti descrivono le differenze tra le API di Creazione report azinedali di Azure meno recenti e le API di Gestione dei costi Microsoft più recenti.

Utilizzo	API di Creazione report aziendali di Azure	API di Gestione dei costi Microsoft
Autenticazione	Chiave API di cui è stato effettuato il provisioning nel portale di Azure	Autenticazione di Microsoft Entra tramite token utente o entità servizio. Le entità servizio prendono il posto delle chiavi API.
Ambiti e autorizzazioni	Tutte le richieste rientrano nell'ambito della registrazione. Le assegnazioni di autorizzazioni con chiave API determineranno se vengono restituiti i dati per l'intera registrazione, per un reparto o per uno specifico account. Nessuna autenticazione utente.	Agli utenti o alle entità servizio viene assegnato l'accesso all'ambito di registrazione, reparto o account.
Endpoint URI	https://consumption.azure.com	https://management.azure.com
Stato di sviluppo	Nessuna, le API vengono ritirate.	Nello sviluppo attivo
API disponibili	Limitato a ciò che è attualmente disponibile	Sono disponibili API equivalenti per sostituire qualsiasi API EA. Sono disponibili anche API di Gestione dei costi Microsoft aggiuntive, tra cui: - Budget - Avvisi - Esportazioni

Elenco di controllo per la migrazione

• Acquisire familiarità con le API REST di Azure Resource Manager.
• Determinare le API di Creazione report aziendali usate e capire le API di Gestione dei costi Microsoft da spostare in Eseguire la migrazione dalle API di Creazione report aziendali di Azure alle API di Gestione dei costi Microsoft.
• Configurare l'autorizzazione e l'autenticazione del servizio per le API di Gestione dei costi Microsoft. Per altre informazioni, leggere Assegnare le autorizzazioni alle API ACM.
• Testare le API e quindi aggiornare qualsiasi codice di programmazione per sostituire le chiamate API di Creazione report aziendali con chiamate API di Gestione dei costi.
• Aggiornare la gestione degli errori per l'uso di nuovi codici errore. Alcune considerazioni di cui tenere conto:
  • Le API di Gestione dei costi Microsoft hanno un periodo di timeout di 60 secondi.
  • Le API di Gestione dei costi Microsoft hanno una limitazione della velocità applicata. Ciò comporta un 429 throttling error se vengono superati i limiti. Sviluppare le soluzioni in modo da non effettuare troppe chiamate alle API in un breve periodo di tempo.
• Esaminare le altre API di Gestione costi disponibili tramite Azure Resource Manager e valutarle per un uso successivo. Per altre informazioni, vedere Eseguire la migrazione dalle API di Creazione report aziendali di Azure alle API di Gestione dei costi Microsoft.

Mapping delle API di Creazione report aziendali alle API di Gestione dei costi

Usare le informazioni seguenti per identificare le API di Creazione report aziendali attualmente in uso e l'API di Gestione dei costi Microsoft sostitutiva da usare.

Scenario	API di Creazione report aziendali	API Gestione costi
Eseguire la migrazione dall'API Dettagli utilizzo EA	/usagedetails/download /usagedetails/submit /usagedetails /usagedetailsbycustomdate	Usare Microsoft.CostManagement/Exports per tutti i carichi di lavoro di inserimento dati ricorrenti. Usare il report Dettagli sui costi per set di dati su richiesta di piccole dimensioni.
Eseguire la migrazione dalle API Riepilogo saldi EA	/balancesummary	Microsoft.Consumption/balances
Eseguire la migrazione dalle API Elenco prezzi EA	/pricesheet	Per i prezzi negoziati, usare Microsoft.Consumption/pricesheets/default Per i prezzi al dettaglio, usare le API Prezzi al dettaglio
Eseguire la migrazione dall'API Dettagli di utilizzo istanze riservate EA	/reservationdetails	Microsoft.CostManagement/generateReservationDetailsReport
Eseguire la migrazione dalle API Riepilogo dell'utilizzo istanze riservate EA	/reservationsummaries	Microsoft.Consumption/reservationSummaries
Eseguire la migrazione dalle API Raccomandazioni sulle istanze riservate EA	/SharedReservationRecommendations /SingleReservationRecommendations	Microsoft.Consumption/reservationRecommendations
Eseguire la migrazione dalle API Addebiti per istanze riservate EA	/reservationcharges	Microsoft.Consumption/reservationTransactions

Usare le API aggiuntive di Gestione costi

Dopo aver eseguito la migrazione alle API di Gestione dei costi Microsoft per gli scenari di report esistenti, è possibile usare anche molte altre API. Le API sono anche disponibili tramite Azure Resource Manager e possono essere automatizzate con l'autenticazione basata su entità servizio. Ecco un breve riepilogo delle nuove funzionalità disponibili.

• Budget: per impostare soglie in modo da monitorare proattivamente i costi, avvisare gli stakeholder di rilievo e automatizzare le azioni in risposta alle violazioni delle soglie.
• Avvisi: per visualizzare informazioni sugli avvisi, tra cui, senza limitazioni, avvisi su budget, su fatture, su crediti e su quote.
• Esportazioni: per pianificare un'esportazione ricorrente dei dati degli addebiti in un account di archiviazione di Azure a scelta. Si tratta della soluzione consigliata per i clienti con una presenza importante di Azure che vogliono analizzare i loro dati nei propri sistemi interni.

Contenuto correlato

• Acquisire familiarità con le API REST di Azure Resource Manager.
• Se necessario, determinare le API di Creazione report aziendali usate e capire le API di Gestione costi da spostare in Eseguire la migrazione dalle API di Creazione report aziendali di Azure alle API di Gestione dei costi Microsoft.
• Se non si usano già API di Azure Resource Manager, registrare l'app client con Microsoft Entra ID.
• Se necessario, aggiornare uno dei codici di programmazione per usare l'autenticazione di Microsoft Entra con l'entità servizio.