Eseguire la migrazione dalle API Dettagli sull'utilizzo EA
I clienti EA che in precedenza usavano le API di creazione report aziendali dietro l'endpoint consumption.azure.com per ottenere i dettagli di utilizzo e gli addebiti del Marketplace devono eseguire la migrazione a soluzioni nuove e migliorate. Le istruzioni sono descritte di seguito insieme alle differenze contrattuali tra l'API precedente e le nuove soluzioni.
Il set di dati viene chiamato dettagli sui costi anziché dettagli di utilizzo.
Nota
Tutte le API di Creazione report aziendali vengono ritirate. È consigliabile Eseguire la migrazione alle API di Gestione dei costi Microsoft il prima possibile.
Nuove soluzioni disponibili a livello generale
La tabella seguente offre un riepilogo delle destinazioni di migrazione disponibili e delle considerazioni da tenere presenti quando si sceglie la soluzione migliore per le proprie esigenze.
| Soluzione | Descrizione | Considerazioni | Informazioni sull'onboarding |
|---|---|---|---|
| Esportazioni | Dump dei dati ricorrenti nella risorsa di archiviazione in base a una pianificazione | - È la soluzione più scalabile per i carichi di lavoro. - Può essere configurata per il partizionamento dei file per set di dati più grandi. - È ideale per stabilire e aumentare un set di dati sui costi, che può essere integrato con gli archivi dati disponibili per query. -Richiede l'accesso a un account di archiviazione che può contenere i dati. |
- Configurare il portale di Azure Automatizzare la creazione delle esportazioni con l'API - Informazioni di riferimento sull'API per le esportazioni |
| API dei dettagli sui costi | Download su richiesta | - Utile per set di dati di costi di piccole dimensioni. - Utile per gli scenari in cui le esportazioni in archiviazione di Azure non sono fattibili a causa di problemi di sicurezza o gestibilità. |
- Ottenere su richiesta set di dati di piccole dimensioni API - dei dettagli sui costi |
In generale, si consiglia di usare Esportazioni se si hanno esigenze di inserimento continuo dei dati e/o se si ha un ampio set di dati mensili sui dettagli dei costi. Per altre informazioni, vedere Inserire i dati sui dettagli dei costi. Se sono necessarie altre informazioni per prendere una decisione relativa al carico di lavoro, vedere Scegliere una soluzione per i dettagli dei costi.
Assegnare le autorizzazioni a un nome dell'entità servizio per chiamare le API
Se si vuole chiamare le API Export o Cost Details a livello di codice, è necessario configurare un'entità servizio con l'autorizzazione corretta. Per altre informazioni, vedere Assegnare le autorizzazioni alle API ACM.
Evitare l'API Dettagli utilizzo a consumo Microsoft
L'API Dettagli utilizzo a consumo è un altro endpoint che supporta attualmente i clienti EA. Non eseguire la migrazione a questa API. Eseguire la migrazione alle API Esportazioni o Dettagli costo, come descritto in precedenza in questo documento. L'API Dettagli utilizzo consumo sarà deprecata in futuro e si trova dietro l'endpoint seguente.
GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2021-10-01
Questa API è un endpoint sincrono e non sarà in grado di dimensionare né la spesa né la dimensione degli aumenti del set di dati dei costi da un mese all'altro. Se attualmente si usa l'API Dettagli utilizzo consumo, è consigliabile eseguire la migrazione all'API Esportazioni o Dettagli costo il prima possibile. Un annuncio formale di deprecazione verrà effettuato in una data futura. Per altre informazioni sulla migrazione da Dettagli utilizzo consumo, vedere Eseguire la migrazione dall'API Dettagli utilizzo consumo.
Vantaggi della migrazione
Le nuove soluzioni offrono molti vantaggi rispetto alle API sui dettagli utilizzo per la creazione di report EA. Di seguito è disponibile un riepilogo:
- Sicurezza e stabilità: le nuove soluzioni richiedono token di entità servizio e/o utente per accedere ai dati. Sono più sicuri delle chiavi API usate per l'autenticazione nelle API di creazione di report EA. Le chiavi in queste API legacy sono valide per sei mesi e possono esporre i dati finanziari sensibili in caso di perdita. Inoltre, se le chiavi non vengono rinnovate e integrate nei carichi di lavoro prima della scadenza dei sei mesi, l'accesso ai dati viene revocato. Ciò interrompe i carichi di lavoro dei clienti.
- Scalabilità: le API di creazione di report EA non sono pensate per essere dimensionate man mano che l'utilizzo di Azure aumenta. Il set di dati dei dettagli di utilizzo può raggiungere dimensioni estremamente elevate quando si distribuiscono più risorse nel cloud. Le nuove soluzioni sono asincrone e presentano ampi miglioramenti infrastrutturali per garantire download senza problemi di set di dati di qualsiasi dimensione.
- Set di dati singolo per tutti i dettagli di utilizzo: i dettagli di utilizzo di Azure e Azure Marketplace sono stati uniti in un set di dati nelle nuove soluzioni. Il set di dati singolo riduce il numero di API che è necessario chiamare per visualizzare tutti gli addebiti.
- Ammortamento degli acquisti: i clienti che acquistano prenotazioni possono visualizzare i costi ammortizzati usando le nuove soluzioni.
- Coerenza dello schema: ogni soluzione disponibile fornisce file con campi corrispondenti e consente di passare facilmente da una soluzione all'altra in base allo scenario.
- Integrazione dell'allocazione dei costi: Contratto Enterprise e Contratto del cliente Microsoft clienti possono usare la nuova soluzione per visualizzare gli addebiti in relazione alle regole di allocazione dei costi configurate. Per altre informazioni sull'allocazione dei costi, leggere Allocare i costi.
- Miglioramenti in corso: le nuove soluzioni vengono sviluppate attivamente in corso d'opera. Le soluzioni ricevono tutte le nuove funzionalità non appena vengono rilasciate.
API di utilizzo aziendale da cui eseguire la migrazione
La tabella seguente riepiloga le diverse API che potrebbero essere attualmente in uso per inserire i dati dei dettagli sui costi. Se si usa una delle API seguenti, è necessario eseguire la migrazione a una delle nuove soluzioni descritte in precedenza. Tutte le API sono dietro l'endpoint https://consumption.azure.com .
| Endpoint | Commenti sull'API |
|---|---|
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod} |
- Metodo API: GET - Sincrona (senza polling) - Formato dati: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10 |
- Metodo API: GET - Sincrona (senza polling) - Formato dati: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails |
- Metodo API: GET - Sincrona (senza polling) - Formato dati: JSON |
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails |
- Metodo API: GET - Sincrona (senza polling) - Formato dati: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10 |
- Metodo API: GET - Sincrona (senza polling) - Formato dati: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod} |
- Metodo API: POST - Asincrona (basata sul polling) - Formato dati: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10 |
- Metodo API: POST - Asincrona (basata sul polling) - Formato dati: CSV |
Mapping dei campi dati
La tabella seguente fornisce un riepilogo dei campi precedenti disponibili nelle soluzioni attualmente in uso insieme al campo da usare nelle nuove soluzioni.
| Campo precedente | Nuovo campo | Commenti |
|---|---|---|
| accountId | ||
| accountName | AccountName | |
| accountOwnerEmail | AccountOwnerId | |
| additionalInfo | AdditionalInfo | |
| chargesBilledSeparately | isAzureCreditEligible | Le proprietà sono opposte. Se isAzureCreditEnabled è true, ChargesBilledSeparately sarebbe false. |
| consumedQuantity | Quantità | |
| consumedService | ConsumedService | |
| consumedServiceId | ConsumedService | consumedServiceId fornisce solo un valore numerico.ConsumedService fornisce il nome del servizio. |
| cost | CostInBillingCurrency | |
| costCenter | CostCenter | |
| data | Data | Il formato nel campo precedente era aa-mm-gg, mentre il nuovo campo è nel formato mm/gg/aaaa. |
| departmentId | InvoiceSectionId | |
| departmentName | InvoiceSectionName | |
| extendedCost | CostInBillingCurrency | |
| instanceId | ResourceId | |
| isRecurringCharge | Se applicabile, usare Frequency e Term fields procedere. |
|
| location | ResourceLocationNormalized | |
| meterCategory | MeterCategory | |
| meterId | ID contatore | |
| meterName | MeterName | |
| meterRegion | MeterRegion | |
| meterSubCategory | MeterSubCategory | |
| offerId | OfferId | |
| orderNumber | Non disponibile. | |
| partNumber | PartNumber | |
| planName | PlanName | |
| product | ProductName | |
| publisherName | PublisherName | |
| resourceGroup | ResourceGroup | |
| resourceGuid | ID contatore | I valori variano. resourceGuid è un valore GUID. meterId è un numero lungo. |
| resourceLocation | ResourceLocation | |
| resourceLocationId | Non disponibile. | |
| resourceRate | EffectivePrice | |
| serviceInfo1 | ServiceInfo1 | |
| serviceInfo2 | ServiceInfo2 | |
| serviceName | MeterCategory | |
| serviceTier | MeterSubCategory | |
| storeServiceIdentifier | Non disponibile. | |
| subscriptionGuid | SubscriptionId | |
| subscriptionId | SubscriptionId | |
| subscriptionName | SubscriptionName | |
| tag | Tag | Il nuovo campo non include le {} coppie chiave-valore. |
| unitOfMeasure | UnitOfMeasure |