Eseguire la migrazione delle API dal Contratto Enterprise al Contratto del cliente Microsoft
Questo articolo illustra le differenze della struttura dei dati, delle API e di altre integrazioni di sistema tra gli account Contratto Enterprise (EA) e Contratto del cliente Microsoft. Gestione dei costi supporta le API per entrambi i tipi di account. Prima di continuare, vedere l'articolo Configurare l'account di fatturazione per un Contratto del cliente Microsoft.
È consigliabile che le organizzazioni con un account EA esistente leggano questo articolo durante la configurazione di un account MCA. In precedenza, il rinnovo di un account EA richiedeva un minimo intervento per passare da una registrazione a una nuova. La migrazione a un account MCA, invece, richiede un'attività aggiuntiva. Il motivo è dovuto alle modifiche del sottosistema di fatturazione sottostante, che influiscono su tutte le API correlate ai costi e sulle offerte di servizi.
API MCA e integrazione
Le API MCA e la nuova integrazione consentono di:
- Avere disponibilità completa di API tramite le API native di Azure.
- Configurare più fatture in un singolo account di fatturazione.
- Accedere a un'API combinata con l'utilizzo di servizi di Azure, l'utilizzo del Marketplace di terze parti e gli acquisti nel Marketplace.
- Visualizzare i costi in vari profili di fatturazione (come per le registrazioni) tramite Gestione dei costi.
- Accedere alle nuove API per visualizzare i costi, ricevere notifiche quando i costi superano le soglie predefinite ed esportare automaticamente i dati non elaborati.
Elenco di controllo per la migrazione
Gli elementi seguenti facilitano la transizione alle API MCA.
- Acquisire familiarità con il nuovo account di fatturazione del Contratto del cliente Microsoft.
- Identificare le API in uso e verificare quali vengono sostituite nella sezione seguente.
- Acquisire familiarità con le API REST di Azure Resource Manager.
- Se non si usano già API di Azure Resource Manager, registrare l'app client con Microsoft Entra ID.
- Concedere all'applicazione creata durante la registrazione dell'app Microsoft Entra l'accesso in lettura all'account di fatturazione usando il controllo di accesso (IAM).
- Aggiornare il codice di programmazione per l'uso dell'autenticazione di Microsoft Entra.
- Aggiornare il codice di programmazione per sostituire le chiamate alle API EA con le chiamate alle API MCA.
- Aggiornare la gestione degli errori per l'uso di nuovi codici errore.
- Per altre azioni necessarie, esaminare le offerte di integrazione aggiuntive, ad esempio Power BI.
API EA sostituite con API MCA
Le API EA usano una chiave API per l'autenticazione e l'autorizzazione. Le API MCA usano l'autenticazione Microsoft Entra.
Nota
Tutte le API di creazione report enterprise di Azure vengono ritirati. È consigliabile eseguire la migrazione alle API di Gestione costi Microsoft il prima possibile.
| Scopo | API EA | API MCA |
|---|---|---|
| Saldo e crediti | /balancesummary | Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae |
| Utilizzo (JSON) | /usagedetails/usagedetailsbycustomdate | Scegliere una soluzione per i dettagli dei costi |
| Utilizzo (CSV) | /usagedetails/download/usagedetails/submit | Scegliere una soluzione per i dettagli dei costi |
| Utilizzo del Marketplace (CSV) | /marketplacecharges/marketplacechargesbycustomdate | Scegliere una soluzione per i dettagli dei costi |
| Periodi di fatturazione | /billingperiods | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Elenco prezzi | /pricesheet | Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json|csv Microsoft.Billing/billingAccounts/…/billingProfiles//…invoices/… /pricesheet/default/download format=json|csv Microsoft.Billing/billingAccounts/../billingProfiles/../providers/Microsoft.Consumption/pricesheets/download |
| Acquisti di prenotazioni | /reservationcharges | Microsoft.Billing/billingAccounts/billingProfiles/transactions |
| Raccomandazioni sulle prenotazioni | /SharedReservationRecommendations/SingleReservationRecommendations | Microsoft.Consumption/reservationRecommendations |
| Utilizzo delle prenotazioni | /reservationdetails/reservationsummaries | Microsoft.Consumption/reservationDetailsMicrosoft.Consumption/reservationSummaries |
¹ I dati sull'utilizzo dei servizi di Azure e del Marketplace di terze parti sono disponibili con l'API Dettagli utilizzo.
Per gli account di fatturazione MCA sono disponibili le API seguenti:
| Scopo | API Contratto del cliente Microsoft (MCA) |
|---|---|
| Account di fatturazione² | Microsoft.Billing/billingAccounts |
| Profili di fatturazione² | Microsoft.Billing/billingAccounts/billingProfiles |
| Sezioni della fattura² | Microsoft.Billing/billingAccounts/invoiceSections |
| Fatture | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Sottoscrizioni di fatturazione | {scope}/billingSubscriptions |
² Le API restituiscono gli elenchi di oggetti, ovvero gli ambiti, in cui operano le esperienze di Gestione dei costi nel portale di Azure e le API. Per altre informazioni sugli ambiti di Gestione costi, vedere Informazioni e utilizzo degli ambiti.
Se si usano API EA esistenti, è necessario aggiornarle per supportare gli account di fatturazione MCA. La tabella seguente illustra altre modifiche di integrazione:
| Scopo | Vecchia offerta | Nuova offerta |
|---|---|---|
| Power BI | Pacchetto di contenuto e connettore Informazioni cognitive dettagliate sul consumo di Microsoft | Connettore Informazioni dettagliate sul consumo di Azure |
API per ottenere saldo e crediti
L'API Get Balance Summary fornisce un riepilogo mensile di:
- Saldi
- Nuovi acquisti
- Addebiti per il servizio Azure Marketplace
- Rettifiche
- Addebiti per eccedenza del servizio
Tutte le API a consumo vengono sostituite da API native di Azure che usano Microsoft Entra ID per l'autenticazione e l'autorizzazione. Per altre informazioni sulle chiamate alle API REST di Azure, vedere Introduzione a REST.
L'API Get Balance Summary viene sostituita dall'API Microsoft.Billing/billingAccounts/billingProfiles/availableBalance.
Per ottenere i saldi disponibili con l'API Available Balance:
| metodo | URI della richiesta |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview |
API per ottenere dati su costi e utilizzo
Le API seguenti consentono di ottenere una scomposizione quotidiana dei costi derivanti dall'utilizzo di servizi di Azure, dall'utilizzo del Marketplace di terze parti e da altri acquisti nel Marketplace. Le seguenti API distinte sono state unite per i servizi di Azure e per l'utilizzo del Marketplace di terze parti. Le API precedenti vengono sostituite dall'API Esportazioni o dall'API Dettagli dei costi. Per scegliere la soluzione più adatta, vedere Scegliere una soluzione per i dettagli dei costi. Entrambe le soluzioni forniscono lo stesso file Dettagli dei costi e dispongono di acquisti nel marketplace nei dati, che in precedenza venivano visualizzati solo nel riepilogo del saldo fino a oggi.
- Get usage detail/download
- Get usage detail/submit
- Get usage detail/usagedetails
- Get usage detail/usagedetailsbycustomdate
- Get marketplace store charge/marketplacecharges
- Get marketplace store charge/marketplacechargesbycustomdate
Le API Esportazioni e Dettagli dei costi, come tutte le API di Gestione dei costi, sono disponibili in più ambiti. Per i costi fatturati, che in genere si ricevono a livello di registrazione, usare l'ambito del profilo di fatturazione. Per altre informazioni sugli ambiti di Gestione costi, vedere Informazioni e utilizzo degli ambiti.
| Type | Formato ID |
|---|---|
| Account di fatturazione | /Microsoft.Billing/billingAccounts/{billingAccountId} |
| Profilo di fatturazione | /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} |
| Abbonamento | /subscriptions/{subscriptionId} |
| Gruppo di risorse | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName} |
Alcuni nomi di proprietà sono stati modificati nel nuovo set di dati Dettagli dei costi disponibile tramite le API Esportazioni e Dettagli dei costi. La tabella seguente mostra le proprietà corrispondenti.
| Vecchia proprietà | Nuova proprietà | Note |
|---|---|---|
| AccountId | N/D | L'autore della sottoscrizione non viene registrato. Usare invoiceSectionId (uguale a departmentId). |
| AccountNameAccountOwnerId e AccountOwnerEmail | N/D | L'autore della sottoscrizione non viene registrato. Usare invoiceSectionName (uguale a departmentName). |
| AdditionalInfo | additionalInfo | |
| ChargesBilledSeparately | isAzureCreditEligible | Le proprietà sono opposte. Se isAzureCreditEnabled è true, ChargesBilledSeparately sarà false. |
| ConsumedQuantity | quantity | |
| ConsumedService | consumedService | I valori di stringa esatti potrebbero essere diversi. |
| ConsumedServiceId | None | |
| CostCenter | costCenter | |
| Date e usageStartDate | data | |
| Giornaliera | None | Analizza il giorno dalla data. |
| DepartmentId | invoiceSectionId | I valori esatti sono diversi. |
| DepartmentName | invoiceSectionName | I valori di stringa esatti potrebbero essere diversi. Configurare le sezioni della fattura in base ai reparti, se necessario. |
| ExtendedCost e Cost | costInBillingCurrency | |
| InstanceId | resourceId | |
| Is Recurring Charge | None | |
| Ufficio | posizione | |
| MeterCategory | meterCategory | I valori di stringa esatti potrebbero essere diversi. |
| ID contatore | meterId | I valori di stringa esatti sono diversi. |
| MeterName | meterName | I valori di stringa esatti potrebbero essere diversi. |
| MeterRegion | meterRegion | I valori di stringa esatti potrebbero essere diversi. |
| MeterSubCategory | meterSubCategory | I valori di stringa esatti potrebbero essere diversi. |
| Mese | None | Analizza il mese dalla data. |
| Nome dell'offerta | None | Usare publisherName e productOrderName. |
| OfferID | None | |
| Numero ordine | None | |
| PartNumber | None | Usare meterId e productOrderName per identificare in modo univoco i prezzi. |
| Plan Name | productOrderName | |
| Prodotto | Prodotto | |
| ProductId | productId | I valori di stringa esatti sono diversi. |
| Nome dell'autore | publisherName | |
| ResourceGroup | resourceGroupName | |
| ResourceGuid | meterId | I valori di stringa esatti sono diversi. |
| ResourceLocation | resourceLocation | |
| ResourceLocationId | None | |
| ResourceRate | effectivePrice | |
| ServiceAdministratorId | N/D | |
| ServiceInfo1 | serviceInfo1 | |
| ServiceInfo2 | serviceInfo2 | |
| ServiceName | meterCategory | I valori di stringa esatti potrebbero essere diversi. |
| ServiceTier | meterSubCategory | I valori di stringa esatti potrebbero essere diversi. |
| StoreServiceIdentifier | N/D | |
| SubscriptionGuid | subscriptionId | |
| SubscriptionId | subscriptionId | |
| SubscriptionName | subscriptionName | |
| Tag | tag | La proprietà tags si applica all'oggetto radice, non alla proprietà annidata properties. |
| UnitOfMeasure | unitOfMeasure | I valori di stringa esatti sono diversi. |
| usageEndDate | data | |
| Anno | None | Analizza l'anno dalla data. |
| (nuova) | billingCurrency | Valuta usata per l'addebito. |
| (nuova) | billingProfileId | ID univoco per il profilo di fatturazione (uguale alla registrazione). |
| (nuova) | billingProfileName | Nome del profilo di fatturazione (uguale alla registrazione). |
| (nuova) | chargeType | Da usare per differenziare l'utilizzo dei servizi di Azure, l'utilizzo del Marketplace e gli acquisti. |
| (nuova) | invoiceId | ID univoco per la fattura. Vuota per il mese corrente aperto. |
| (nuova) | publisherType | Tipo di server di pubblicazione per gli acquisti. Vuota per l'utilizzo. |
| (nuova) | serviceFamily | Tipo di acquisto. Vuota per l'utilizzo. |
| (nuova) | servicePeriodStartDate | Data di fine per il servizio acquistato. |
| (nuova) | servicePeriodStartDate | Data di inizio per il servizio acquistato. |
API Billing Periods sostituite da API Invoices
Gli account di fatturazione MCA non usano i periodi di fatturazione. Usano invece le fatture per definire l'ambito dei costi in specifici periodi di fatturazione. L'API Billing Periods viene sostituita dall'API Invoices. Tutte le API a consumo vengono sostituite da API native di Azure che usano Microsoft Entra ID per l'autenticazione e l'autorizzazione. Per altre informazioni sulle chiamate alle API REST di Azure, vedere Introduzione a REST.
Per ottenere le fatture con l'API Invoices:
| metodo | URI della richiesta |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview |
API Price Sheet
Questa sezione descrive le attuali API Price Sheet e fornisce raccomandazioni per il passaggio all'API Price Sheet per i Contratti del cliente Microsoft. Descrive inoltre l'API Price Sheet per i Contratti del cliente Microsoft e i campi inclusi negli elenchi prezzi. Le API Enterprise Get price sheet e Enterprise Get billing periods vengono sostituite dall'API Price Sheet per i Contratti del cliente Microsoft (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). La nuova API supporta sia i formati JSON che CSV, nei formati REST asincroni. Tutte le API a consumo vengono sostituite da API native di Azure che usano Microsoft Entra ID per l'autenticazione e l'autorizzazione. Per altre informazioni sulle chiamate alle API REST di Azure, vedere Introduzione a REST.
API Billing Enterprise
Le API Billing Enterprise si usano con le registrazioni Enterprise per ottenere informazioni su prezzi e periodi di fatturazione. L'autenticazione e l'autorizzazione vengono gestite tramite token Web di Microsoft Entra.
Per ottenere i prezzi applicabili per la registrazione Enterprise specificata con le API Price Sheet e Billing Period:
| metodo | URI della richiesta |
|---|---|
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet |
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet |
API Price Sheet per i Contratti del cliente Microsoft
Usare l'API Price Sheet per i Contratti del cliente Microsoft per visualizzare i prezzi per tutti i servizi a consumo di Azure e del Marketplace. I prezzi mostrati per il profilo di fatturazione si applicano a tutte le sottoscrizioni che include.
Usare l'API Price Sheet per visualizzare i dati sugli elenchi prezzi dei servizi a consumo di Azure in formato CSV:
| metodo | URI della richiesta |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=csv |
Usare l'API Price Sheet per visualizzare i dati sugli elenchi prezzi dei servizi a consumo di Azure in formato JSON:
| metodo | URI della richiesta |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=json |
L'uso dell'API restituisce l'elenco prezzi per l'intero account. Tuttavia, è anche possibile ottenere una versione ridotta dell'elenco prezzi in formato PDF. Il riepilogo include i servizi a consumo di Azure e del Marketplace fatturato per una specifica fattura. La fattura è identificata tramite {invoiceId}, che corrisponde esattamente al numero di fattura riportato nei file PDF Riepilogo fattura. Ecco un esempio.
Per visualizzare informazioni sulla fattura con l'API Price Sheet in formato CSV:
| metodo | URI della richiesta |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Per visualizzare informazioni sulla fattura con l'API Price Sheet in formato JSON:
| metodo | URI della richiesta |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
È anche possibile visualizzare i prezzi stimati per qualsiasi servizio a consumo di Azure o del Marketplace nel ciclo di fatturazione aperto corrente o nel periodo del servizio.
Per visualizzare i prezzi stimati per i servizi a consumo con l'API Price Sheet in formato CSV:
| metodo | URI della richiesta |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Per visualizzare i prezzi stimati per i servizi a consumo con l'API Price Sheet in formato JSON:
| metodo | URI della richiesta |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
Le API Price Sheet per i Contratti del cliente Microsoft sono API REST asincrone. Le risposte per le API sono diverse rispetto alle API sincrone precedenti. Anche il corpo della risposta dell'API è cambiato.
Vecchio corpo della risposta
Ecco un esempio di risposta dell'API REST sincrona:
[
{
"id": "enrollments/573549891/billingperiods/2016011/products/343/pricesheets",
"billingPeriodId": "201704",
"meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
"meterName": "A1 VM",
"unitOfMeasure": "100 Hours",
"includedQuantity": 0,
"partNumber": "N7H-00015",
"unitPrice": 0.00,
"currencyCode": "USD"
},
{
]
Nuovo corpo della risposta
Le API supportano il formato Azure REST asincrono. Chiamare l'API usando GET per ricevere la risposta seguente:
No Response Body
HTTP Status 202 Accepted
Le intestazioni seguenti vengono inviate con la posizione dell'output:
Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Azure-AsyncOperation:https://managment.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Retry-After: 10
OData-EntityId: {operationId}
Effettuare un'altra chiamata GET per la posizione. La risposta alla chiamata GET è la stessa finché l'operazione non raggiunge uno stato di completamento o di errore. Al termine, la risposta alla chiamata GET per la posizione restituisce l'URL di download, come se l'operazione venisse eseguita contemporaneamente. Ecco un esempio:
HTTP Status 200
{
"id": "providers/Microsoft.Consumption/operationresults/{operationId}",
"name": {operationId},
"type": “Microsoft.Consumption/operationResults",
"properties" : {
"downloadUrl": {urltoblob},
"validTill": "Date"
}
}
Anche il client può effettuare una chiamata GET per Azure-AsyncOperation. L'endpoint restituisce lo stato dell'operazione.
La tabella seguente illustra i campi dell'API Enterprise Get price sheet precedente. Include i campi corrispondenti del nuovo elenco prezzi per i Contratti del cliente Microsoft:
| Vecchia proprietà | Nuova proprietà | Note |
|---|---|---|
| billingPeriodId | Non applicabile | Non applicabile. Per i Contratti del cliente Microsoft, la fattura e l'elenco prezzi associato sostituiscono il concetto di billingPeriodId. |
| meterId | meterId | |
| unitOfMeasure | unitOfMeasure | I valori di stringa esatti potrebbero essere diversi. |
| includedQuantity | includedQuantity | Non applicabile ai servizi nei Contratti del cliente Microsoft. |
| partNumber | Non applicabile | Usare invece una combinazione di productOrderName (uguale a offerID) e meterID. |
| unitPrice | unitPrice | Il prezzo unitario è applicabile per i servizi usati nei Contratti del cliente Microsoft. |
| currencyCode | pricingCurrency | I Contratti del cliente Microsoft rappresentano i prezzi in valuta prezzi e valuta di fatturazione. currencyCode corrisponde a pricingCurrency nei Contratti del cliente Microsoft. |
| offerID | productOrderName | Invece di OfferID, è possibile usare productOrderName ma non è uguale a OfferID. Tuttavia, productOrderName e meter determinano i prezzi nei Contratti del cliente Microsoft correlati a meterId e OfferID nelle registrazioni legacy. |
Operazioni dell'API Consumption Price Sheet
Per i Contratti Enterprise si usano le operazioni Get e Get By Billing Period dell'API Consumption Price Sheet per un ambito in base a subscriptionId o a periodo di fatturazione. L'API usa l'autenticazione di Azure Resource Management.
Per ottenere informazioni sull'elenco prezzi per un ambito con l'API Price Sheet:
| metodo | URI della richiesta |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Per ottenere informazioni sull'elenco prezzi in base a periodo di fatturazione con l'API Price Sheet:
| metodo | URI della richiesta |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Invece degli endpoint API precedenti, usare quelli seguenti per i Contratti del cliente Microsoft:
API Price Sheet per i Contratti del cliente Microsoft (API REST asincrone)
Questa API è destinata ai Contratti del cliente Microsoft e prevede attributi aggiuntivi.
Elenco prezzi per un ambito del profilo di fatturazione in un account di fatturazione
Questa è l'API esistente. È stata aggiornata per fornire l'elenco prezzi per un profilo di fatturazione in un account di fatturazione.
Elenco prezzi per un ambito in base ad account di fatturazione
L'autenticazione di Azure Resource Manager si usa quando si ottiene l'elenco prezzi nell'ambito di registrazione in un account di fatturazione.
Per ottenere l'elenco prezzi a livello di account di registrazione in un account di fatturazione:
| metodo | URI della richiesta |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
Per un Contratto del cliente Microsoft, usare le informazioni della sezione seguente. Fornisce le proprietà dei campi usati per i Contratti del cliente Microsoft.
Elenco prezzi per un ambito del profilo di fatturazione in un account di fatturazione
L'API aggiornata in base ad account di fatturazione ottiene l'elenco prezzi in formato CSV. Per ottenere l'elenco prezzi nell'ambito del profilo di fatturazione per un contratto MCA:
| metodo | URI della richiesta |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/28ae4b7f-41bb-581e-9fa4-8270c857aa5f/billingProfiles/ef37facb-cd6f-437a-9261-65df15b673f9/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
Nell'ambito di registrazione del contratto EA, la risposta e le proprietà dell'API sono identiche. Le proprietà corrispondono alle stesse proprietà di MCA.
Le proprietà precedenti per le API Price Sheet di Azure Resource Manager e le nuove proprietà corrispondenti sono indicate nella tabella seguente.
| Proprietà della vecchia API Price Sheet di Azure Resource Manager | Proprietà della nuova API Price Sheet del Contratto del cliente Microsoft | Descrizione |
|---|---|---|
| ID contatore | meterId | Identificatore univoco del contatore. Uguale a meterID. |
| Nome contatore | meterName | Nome del contatore. Il contatore rappresenta la risorsa distribuibile di un servizio di Azure. |
| Categoria del contatore | servizio | Nome della categoria di classificazione per il contatore. Uguale al servizio nell'elenco prezzi del Contratto del cliente Microsoft. I valori di stringa esatti sono diversi. |
| Sottocategoria di contatore | meterSubCategory | Nome della categoria di sottoclassificazione del contatore. In base alla classificazione di differenziazione dei set di funzionalità di alto livello nel servizio. Ad esempio, database SQL di base rispetto a database SQL standard. |
| Area contatore | meterRegion | |
| Unità | Non applicabile | Può essere analizzato da unitOfMeasure. |
| Unità di misura | unitOfMeasure | |
| Numero parte | Non applicabile | Invece del numero parte, usare productOrderName e MeterID per identificare in modo univoco il prezzo per un profilo di fatturazione. Nella fattura MCA sono riportati i campi invece del numero parte. |
| Prezzo unitario | unitPrice | Prezzo unitario del Contratto del cliente Microsoft. |
| Codice valuta | pricingCurrency | I Contratti del cliente Microsoft rappresentano i prezzi in valuta prezzi e valuta di fatturazione. Il codice valuta è uguale a pricingCurrency nei Contratti del cliente Microsoft. |
| Quantità inclusa | includedQuantity | Non applicabile ai servizi nei Contratti del cliente Microsoft. Visualizza valori zero. |
| ID offerta | productOrderName | Invece di OfferID, usare productOrderName. Non è uguale a OfferID, ma productOrderName e meter determinano i prezzi nei Contratti dei clienti Microsoft. È correlata a meterId e OfferID nelle registrazioni legacy. |
Il prezzo per i Contratti con i clienti Microsoft è definito in modo diverso rispetto ai Contratti Enterprise. Il prezzo per i servizi nella registrazione Enterprise è univoco per prodotto, numero parte, contatore e offerta. Il numero parte non viene usato nei Contratti con i clienti Microsoft.
Il prezzo dei servizi a consumo di Azure che fanno parte di un Contratto del cliente Microsoft è univoco per productOrderName e meterID, che rappresentano il contatore del servizio e il piano del prodotto.
Per riconciliare tra l'elenco prezzi e l'utilizzo nell'API Usage Details, è possibile usare productOrderName e meterID.
Gli utenti con diritti di proprietario, collaboratore, lettore e gestione fatture nel profilo di fatturazione possono scaricare l'elenco prezzi.
L'elenco prezzi riguarda i servizi il cui prezzo è basato sull'utilizzo. I servizi includono quelli a consumo di Azure e a consumo del Marketplace. L'ultimo prezzo alla fine di ogni periodo di servizio è bloccato e viene applicato all'utilizzo in un singolo periodo di servizio. Per i servizi a consumo di Azure, il periodo di servizio è in genere un mese di calendario.
Campi ritirati dell'API Price Sheet
I campi seguenti non sono disponibili nelle API Price Sheet del Contratto del cliente Microsoft oppure sono uguali.
| Campo ritirato | Descrizione |
|---|---|
| billingPeriodId | Non applicabile. Corrisponde a InvoiceId per MCA. |
| offerID | Non applicabile. Corrisponde a productOrderName in MCA. |
| meterCategory | Non applicabile. Corrisponde a Service per MCA. |
| unitàà | Non applicabile. Può essere analizzato da unitOfMeasure. |
| currencyCode | Uguale a pricingCurrency in MCA. |
| meterLocation | Uguale a meterRegion in MCA. |
| partNumber | Non applicabile perché il numero parte non è incluso nelle fatture MCA. Invece del numero parte, usare la combinazione meterId e productOrderName per identificare in modo univoco i prezzi. |
| totalIncludedQuantity | Non applicabile. |
| pretaxStandardRate | Non applicabile. |
API Reservation Instance Charge sostituita
Con l'API Reserved Instance Charge, è possibile ottenere le transazioni di fatturazione per gli acquisti di prenotazioni. La nuova API include tutti gli acquisti, incluse le offerte del Marketplace di terze parti. Tutte le API a consumo vengono sostituite da API native di Azure che usano Microsoft Entra ID per l'autenticazione e l'autorizzazione. Per altre informazioni sulle chiamate alle API REST di Azure, vedere Introduzione a REST. L'API Reserved Instance Charge viene sostituita dall'API Transaction.
Per ottenere le transazioni di acquisto di prenotazioni con l'API Transactions:
| metodo | URI della richiesta |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview |
API Recommendations sostituita
Le API Reserved Instance Purchase Recommendations forniscono dati di utilizzo delle macchine virtuali relativi agli ultimi 7, 30 o 60 giorni. Le API forniscono anche raccomandazioni per l'acquisto di prenotazioni. che includono:
Tutte le API a consumo vengono sostituite da API native di Azure che usano Microsoft Entra ID per l'autenticazione e l'autorizzazione. Per altre informazioni sulle chiamate alle API REST di Azure, vedere Introduzione a REST. Le API di raccomandazioni sulle prenotazioni elencate sopra vengono sostituite dall'API Microsoft.Consumption/reservationRecommendations.
Per ottenere raccomandazioni sulle prenotazioni con l'API Reservation Recommendations:
| metodo | URI della richiesta |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01 |
API Reservation Usage sostituite
Con l'API Reserved Instance Usage, è possibile ottenere dati di utilizzo delle prenotazioni in una registrazione. Se una registrazione include più di un'istanza riservata, con questa API è anche possibile ottenere dati di utilizzo di tutte le istanze riservate acquistate.
che includono:
Tutte le API a consumo vengono sostituite da API native di Azure che usano Microsoft Entra ID per l'autenticazione e l'autorizzazione. Per altre informazioni sulle chiamate alle API REST di Azure, vedere Introduzione a REST. Le API di raccomandazioni sulle prenotazioni elencate sopra vengono sostituite dalle API Microsoft.Consumption/reservationDetails e Microsoft.Consumption/reservationSummaries.
Per ottenere i dettagli delle prenotazioni con l'API Reservation Details:
| metodo | URI della richiesta |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01 |
Per ottenere i dettagli delle prenotazioni con l'API Reservation Summaries:
| metodo | URI della richiesta |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01 |
Integrazione di Power BI
Per la creazione di report sui costi, è anche possibile usare Power BI. Il connettore Gestione dei costi per Power BI Desktop può essere usato per creare report avanzati e personalizzati che consentono di comprendere meglio la spesa di Azure. Il connettore Gestione dei costi attualmente supporta i clienti con Contratto del cliente Microsoft o Contratto Enterprise.
Contenuto correlato
- Per informazioni su come monitorare e controllare la spesa di Azure, vedere Documentazione di Gestione costi. Oppure se si vuole ottimizzare l'uso delle risorse con gestione costi.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per