Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
EA customers who were previously using the Enterprise Reporting APIs behind the consumption.azure.com endpoint to obtain usage details and marketplace charges need to migrate to new and improved solutions. Le istruzioni sono descritte di seguito insieme alle differenze contrattuali tra l'API precedente e le nuove soluzioni.
The dataset is referred to as cost details instead of usage details.
Note
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.
| Solution | Description | Considerations | Onboarding info |
|---|---|---|---|
| Exports | 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 - Cost Details API |
Generally we recommend using Exports if you have ongoing data ingestion needs and/or a large monthly cost details dataset. 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.
Migration benefits
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.
- Scalability - The EA Reporting APIs aren't built to scale well as your Azure usage increases. 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.
- Purchase amortization - Customers who purchase Reservations can see an Amortized view of their costs using the new solutions.
- Schema consistency - Each solution that is available provides files with matching fields. 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. For more information about cost allocation, see Allocate costs.
- 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 | API Comments |
|---|---|
/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.
| Old field | New field | Comments |
|---|---|---|
| accountId | ||
| accountName | AccountName | |
| accountOwnerEmail | AccountOwnerId | |
| additionalInfo | AdditionalInfo | |
| chargesBilledSeparately | isAzureCreditEligible | Le proprietà sono opposte. Se isAzureCreditEnabled è true, ChargesBilledSeparately sarebbe false. |
| consumedQuantity | Quantity | |
| consumedService | ConsumedService | |
| consumedServiceId | ConsumedService |
consumedServiceId fornisce solo un valore numerico.ConsumedService fornisce il nome del servizio. |
| cost | CostInBillingCurrency | |
| costCenter | CostCenter | |
| date | Date | 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 | MeterId | |
| meterName | MeterName | |
| meterRegion | MeterRegion | |
| meterSubCategory | MeterSubCategory | |
| offerId | OfferId | |
| orderNumber | Not available. | |
| partNumber | PartNumber | |
| planName | PlanName | |
| product | ProductName | |
| publisherName | PublisherName | |
| resourceGroup | ResourceGroup | |
| resourceGuid | MeterId | Values vary.
resourceGuid è un valore GUID.
meterId è un numero lungo. |
| resourceLocation | ResourceLocation | |
| resourceLocationId | Not available. | |
| resourceRate | EffectivePrice | |
| serviceInfo1 | ServiceInfo1 | |
| serviceInfo2 | ServiceInfo2 | |
| serviceName | MeterCategory | |
| serviceTier | MeterSubCategory | |
| storeServiceIdentifier | Not available. | |
| subscriptionGuid | SubscriptionId | |
| subscriptionId | SubscriptionId | |
| subscriptionName | SubscriptionName | |
| tags | Tags | Il nuovo campo non include le {} coppie chiave-valore. |
| unitOfMeasure | UnitOfMeasure |