Eseguire la migrazione dall'API Dettagli utilizzo a consumo

Questo articolo illustra la migrazione dall'API Dettagli utilizzo a consumo. L'API Dettagli utilizzo a consumo è deprecata. La data in cui l'API verrà disattivata deve ancora essere stabilita. In ogni caso, è consigliabile eseguire la migrazione dall'API il più presto possibile.

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 per cui Esportazioni non è adatta, è 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 estremamente 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. Di seguito è riportato un record dei dettagli sull'utilizzo di 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.

{  

  "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. Di seguito è riportato un record dei dettagli sull'utilizzo di tipo moderno. Tutti i clienti con Contratto del cliente Microsoft hanno a disposizione record di questo tipo come conseguenza dell'applicazione del sistema di fatturazione sottostante.

{  

  "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.