Eseguire la migrazione dall'API Dettagli utilizzo a consumo
Questo articolo illustra la migrazione dall'API Dettagli utilizzo consumo, che è pianificata per la deprecazione. La data esatta della deprecazione è ancora in corso. È consigliabile non compilare le pipeline di report usando questa API ed eseguirne la migrazione il prima possibile.
Le API di creazione report del Contratto Enterprise (EA) che usano una chiave API per l'autenticazione e sono accessibili tramite l'endpoint URI consumption.azure.com sono state ritirate. I clienti EA che usano queste API devono eseguire la migrazione all'API Dettagli costi di Gestione dei costi. Le API di creazione di report EA meno recenti sono disponibili solo per i clienti con un Contratto Enterprise.
Se si usa l'API Dettagli utilizzo consumo si consiglia, ma non è necessario, eseguire la migrazione all'API Dettagli costi di Gestione costi.
Le API a consumo e gestione costi sono disponibili per entrambi i clienti del Contratto del cliente Microsoft EA. I clienti di Azure per enti pubblici che rimangono sotto un contratto Enterprise non sono quindi interessati negativamente.
Quando si esegue la migrazione da EA a McA, è consigliabile passare dall'API Dettagli utilizzo report EA all'API Dettagli costo gestione costi e usare Esportazioni.
Destinazioni di migrazione
Leggere l'articolo Scegliere una soluzione di dettagli sui costi prima di decidere quella più adatta al carico di lavoro. In genere, è consigliabile Esportazioni se ci sono attuali esigenze di inserimento dati e/o un set di dati di dettaglio sull'utilizzo mensile di grandi dimensioni. Per altre informazioni, leggere Inserire i dati di dettagli sull'utilizzo.
Se si dispone di un set di dati di dettagli sull'utilizzo di dimensioni ridotte o ci si trova in uno scenario che non viene soddisfatto dalle Esportazioni, è consigliabile usare il report Dettagli dei costi. Per altre informazioni, leggere Ottenere set di dati di costi ridotti su richiesta.
Nota
Il report Dettagli dei costi è disponibile solo per i clienti con Contratto Enterprise o Contratto del cliente Microsoft. Se si dispone di una sottoscrizione MSDN, con pagamento in base al consumo o di Visual Studio, è possibile eseguire la migrazione a Esportazioni o continuare a usare l'API Dettagli utilizzo a consumo.
Vantaggi della migrazione
Le nuove soluzioni offrono molti vantaggi rispetto all'API Dettagli utilizzo a consumo. Di seguito è disponibile un riepilogo:
- Set di dati singolo per tutti i dettagli di utilizzo: i dettagli di utilizzo di Azure e Azure Marketplace sono stati riuniti in un unico set di dati, in modo da ridurre il numero di API che è necessario chiamare per visualizzare tutti gli addebiti.
- Scalabilità: l'API Marketplaces è deprecata perché alza di livello un criterio di chiamata che non è in grado di dimensionare man mano che aumenta l'utilizzo di Azure. Il set di dati dei dettagli di utilizzo può raggiungere dimensioni elevate quando si distribuiscono più risorse nel cloud. L'API Marketplaces è un'API sincrona impaginata, quindi non è ottimizzata per trasferire in modo efficace grandi volumi di dati in una rete con elevata efficienza e affidabilità. Le Esportazioni e l'API Dettagli dei costi sono asincrone e restituiscono un file CSV che può essere scaricato direttamente in rete.
- Miglioramenti dell'API: le Esportazioni e l'API Dettagli dei costi sono le soluzioni supportate da Azure, perché integrano tutte le nuove funzionalità.
- Coerenza dello schema: il report Dettagli dei costi ed Esportazioni offrono file con i campi corrispondenti, in modo da rendere possibile il passaggio da una soluzione all'altra, in base allo scenario in uso.
- Integrazione dell'allocazione dei costi: i clienti con Contratto Enterprise e con Contratto del cliente Microsoft che usano le Esportazioni o l'API Dettagli dei costi possono visualizzare gli addebiti in relazione alle regole di allocazione dei costi configurate. Per altre informazioni sull'allocazione dei costi, leggere Allocare i costi.
Differenze nei campi
La tabella seguente riepiloga le differenze nei campi tra l'API Dettagli dell'utilizzo a consumo e l'API Esportazioni/Dettagli dei costi. Le Esportazioni e l'API Dettagli dei costi permettono il download di un file CSV anziché la risposta JSON impaginata che proviene dall'API a consumo.
Mapping dei campi del Contratto Enterprise
I clienti con Contratto Enterprise che usano l'API Dettagli di utilizzo a consumo hanno a disposizione record di dettagli sull'utilizzo del tipo legacy. Tutti i clienti con Contratto Enterprise hanno a disposizione record di questo tipo come conseguenza del sistema di fatturazione sottostante a loro applicabile. Ecco un esempio di record dei dettagli di utilizzo legacy:
{
"value": [
{
"id": "{id}",
"name": "{name}",
"type": "Microsoft.Consumption/usageDetails",
"kind": "legacy",
"tags": {
"env": "newcrp",
"dev": "tools"
},
"properties": {
…...
}
}
Un record completo di esempio dei dettagli sull'utilizzo di tipo legacy viene visualizzato in Dettagli sull'utilizzo - Elenco - API REST (consumo di Azure)
Nella tabella seguente viene illustrato un mapping tra i campi precedenti e nuovi. Le nuove proprietà sono disponibili nei file CSV prodotti dalle Esportazioni e dall'API Dettagli dei costi. Per altre informazioni sui campi, leggere Informazioni sui campi dei dettagli di utilizzo.
I nomi delle proprietà in grassetto sono invariati.
| Vecchia proprietà | Nuova proprietà |
|---|---|
| accountName | AccountName |
| AccountOwnerId | AccountOwnerId |
| additionalInfo | AdditionalInfo |
| AvailabilityZone | AvailabilityZone |
| billingAccountId | BillingAccountId |
| billingAccountName | BillingAccountName |
| billingCurrency | BillingCurrencyCode |
| billingPeriodEndDate | BillingPeriodEndDate |
| billingPeriodStartDate | BillingPeriodStartDate |
| billingProfileId | BillingProfileId |
| billingProfileName | BillingProfileName |
| chargeType | ChargeType |
| consumedService | ConsumedService |
| cost | CostInBillingCurrency |
| costCenter | CostCenter |
| data | Data |
| effectivePrice | EffectivePrice |
| frequenza | Frequenza |
| invoiceSection | InvoiceSectionName |
| InvoiceSectionId | InvoiceSectionId |
| isAzureCreditEligible | IsAzureCreditEligible |
| meterCategory | MeterCategory |
| meterId | ID contatore |
| meterName | MeterName |
| MeterRegion | MeterRegion |
| meterSubCategory | MeterSubCategory |
| offerId | OfferId |
| partNumber | PartNumber |
| PayGPrice | PayGPrice |
| PlanName | PlanName |
| PricingModel | PricingModel |
| product | ProductName |
| ProductOrderId | ProductOrderId |
| ProductOrderName | ProductOrderName |
| PublisherName | PublisherName |
| PublisherType | PublisherType |
| quantity | Quantità |
| ReservationId | ReservationId |
| ReservationName | ReservationName |
| resourceGroup | ResourceGroup |
| resourceId | ResourceId |
| resourceLocation | ResourceLocation |
| resourceName | NomeRisorsa |
| serviceFamily | ServiceFamily |
| ServiceInfo1 | ServiceInfo1 |
| ServiceInfo2 | ServiceInfo2 |
| subscriptionId | SubscriptionId |
| subscriptionName | SubscriptionName |
| Tag | Tag |
| Termine | Termine |
| unitOfMeasure | UnitOfMeasure |
| unitPrice | UnitPrice |
| CostAllocationRuleName | CostAllocationRuleName |
Mapping dei campi del Contratto del cliente Microsoft
I clienti con Contratto del cliente Microsoft che usano l'API Dettagli dell'utilizzo a consumo hanno a disposizione record di dettagli sull'utilizzo del tipo modern. Tutti i clienti con Contratto del cliente Microsoft hanno a disposizione record di questo tipo come conseguenza dell'applicazione del sistema di fatturazione sottostante. Di seguito è riportato un esempio di record dei dettagli di utilizzo di McA:
{
"value": [
{
"id": "{id}",
"name": "{name}",
"type": "Microsoft.Consumption/usageDetails",
"kind": "modern",
"tags": {
"env": "newcrp",
"dev": "tools"
},
"properties": {
…...
}
}
Un record completo di esempio dei dettagli sull'utilizzo di tipo legacy viene visualizzato in Dettagli sull'utilizzo - Elenco - API REST (consumo di Azure)
Nella tabella seguente viene illustrato un mapping tra i campi precedenti e nuovi. Le nuove proprietà sono disponibili nei file CSV prodotti dalle Esportazioni e dall'API Dettagli dei costi. I campi che richiedono un mapping a seguito delle differenze tra le soluzioni vengono visualizzati in grassetto.
Per altre informazioni, leggere Informazioni sui campi dei dettagli di utilizzo.
| Vecchia proprietà | Nuova proprietà |
|---|---|
| invoiceId | invoiceId |
| previousInvoiceId | previousInvoiceId |
| billingAccountId | billingAccountId |
| billingAccountName | billingAccountName |
| billingProfileId | billingProfileId |
| billingProfileName | billingProfileName |
| invoiceSectionId | invoiceSectionId |
| invoiceSectionName | invoiceSectionName |
| partnerTenantId | partnerTenantId |
| partnerName | partnerName |
| resellerName | resellerName |
| resellerMpnId | resellerMpnId |
| customerTenantId | customerTenantId |
| customerName | customerName |
| costCenter | costCenter |
| billingPeriodEndDate | billingPeriodEndDate |
| billingPeriodStartDate | billingPeriodStartDate |
| servicePeriodStartDate | servicePeriodStartDate |
| servicePeriodStartDate | servicePeriodStartDate |
| data | data |
| serviceFamily | serviceFamily |
| productOrderId | productOrderId |
| productOrderName | productOrderName |
| consumedService | consumedService |
| meterId | meterId |
| meterName | meterName |
| meterCategory | meterCategory |
| meterSubCategory | meterSubCategory |
| meterRegion | meterRegion |
| productIdentifier | ProductId |
| product | ProductName |
| subscriptionGuid | SubscriptionId |
| subscriptionName | subscriptionName |
| publisherType | publisherType |
| publisherId | publisherId |
| publisherName | publisherName |
| resourceGroup | resourceGroupName |
| instanceName | ResourceId |
| resourceLocationNormalized | location |
| resourceLocation | location |
| effectivePrice | effectivePrice |
| quantity | quantity |
| unitOfMeasure | unitOfMeasure |
| chargeType | chargeType |
| billingCurrencyCode | billingCurrency |
| pricingCurrencyCode | pricingCurrency |
| costInBillingCurrency | costInBillingCurrency |
| costInPricingCurrency | costInPricingCurrency |
| costInUsd | costInUsd |
| paygCostInBillingCurrency | paygCostInBillingCurrency |
| paygCostInUSD | paygCostInUsd |
| exchangeRatePricingToBilling | exchangeRatePricingToBilling |
| exchangeRateDate | exchangeRateDate |
| isAzureCreditEligible | isAzureCreditEligible |
| serviceInfo1 | serviceInfo1 |
| serviceInfo2 | serviceInfo2 |
| additionalInfo | additionalInfo |
| tag | tag |
| partnerEarnedCreditRate | partnerEarnedCreditRate |
| partnerEarnedCreditApplied | partnerEarnedCreditApplied |
| marketPrice | PayGPrice |
| frequenza | frequenza |
| Termine di | Termine di |
| reservationId | reservationId |
| reservationName | reservationName |
| pricingModel | pricingModel |
| unitPrice | unitPrice |
| exchangeRatePricingToBilling | exchangeRatePricingToBilling |
Contenuto correlato
- Altre informazioni su Gestione dei costi e automazione della fatturazione sono disponibili in Panoramica di automazione Gestione dei costi.