Condividi tramite

Eseguire la migrazione dall'API Elenco prezzi EA

  • Articolo

I clienti EA che in precedenza usavano l'API di creazione di report Enterprise consumption.azure.com per ottenere l'elenco dei prezzi devono eseguire la migrazione a un'API di Azure Resource Manager sostitutiva. Le istruzioni seguenti consentono di eseguire la migrazione e descrivono anche eventuali differenze di contratto tra l'API precedente e la nuova API.

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.

Assegnare autorizzazioni a un'entità servizio per chiamare l'API

Prima di chiamare l'API, è necessario configurare un'entità servizio (SPN) con l'autorizzazione corretta. L'entità servizio viene utilizzata per chiamare l'API. Per altre informazioni, vedere Assegnare autorizzazioni alle API di Gestione costi.

Chiamare l'API Elenco prezzi

L'API Elenco prezzi genera l'elenco prezzi in modo asincrono e produce un file scaricato.

Usare gli URI di richiesta seguenti quando si chiama la nuova API Elenco prezzi:

Richieste supportate

È possibile chiamare l'API usando l'ambito seguente:

Registrazione: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Download dall'account di fatturazione per il periodo di fatturazione specificato

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

La richiesta POST restituisce un percorso per eseguire il polling dello stato di generazione del report come descritto nella risposta seguente:

Risposta di esempio

Codice di stato: 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01
Retry-After: 60

Codice di stato: 200

{
  "status": "Completed",
  "properties": {
    "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

Richiesta di esempio per eseguire il polling sullo stato di generazione dei report

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01

Modifiche del corpo della risposta

[
        {
              "id": "enrollments/57354989/billingperiods/201601/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"
        },
        {
              "id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
              "billingPeriodId": "201404",
            "meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
              "meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
              "unitOfMeasure": "100 GB",
              "includedQuantity": 0,
              "partNumber": "N9H-00402",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        ...
]

Nuove modifiche alla risposta

Le proprietà dell'elenco prezzi sono le seguenti:

Nome Tipo Descrizione
basePrice string Prezzo unitario al momento dell'accesso del cliente o prezzo unitario al momento dell'avvio della disponibilità generale del contatore del servizio se è dopo l'accesso.

Si applica agli utenti Contratto Enterprise
currencyCode string Valuta in cui è stato firmato il Contratto Enterprise
effectiveEndDate string Data di fine effettiva del periodo di fatturazione dell'elenco prezzi
effectiveStartDate string Data di inizio effettiva del periodo di fatturazione dell'elenco prezzi
enrollmentNumber string Identificatore univoco per l'account di fatturazione EA.
includedQuantity string Quantità di un servizio specifico a cui un cliente EA ha diritto di utilizzare senza addebiti incrementali.
marketPrice string Il prezzo di listino corrente per un determinato prodotto o servizio. Questo prezzo è senza negoziati ed è basato sul tipo di contratto Microsoft.

Per PriceType Consumption, il prezzo di mercato si riflette come prezzo con pagamento in base al consumo.

Per PriceType Savings Plan, il prezzo di mercato riflette il vantaggio del piano di risparmio oltre al prezzo con pagamento in base al consumo per il periodo di impegno corrispondente.

Per PriceType ReservedInstance, il prezzo di mercato riflette il prezzo totale dell'impegno di uno o tre anni.

Nota: per i clienti EA senza trattative, il prezzo di mercato potrebbe apparire arrotondato a una precisione decimale diversa rispetto al prezzo unitario.
meterCategory string Nome della categoria di classificazione per il contatore. Ad esempio, Servizi cloud, Rete, ecc.
meterId string Identificatore univoco del contatore
meterName string Nome del contatore. Il contatore rappresenta la risorsa distribuibile di un servizio di Azure.
meterRegion string Nome dell'area di Azure in cui è disponibile il contatore per il servizio.
meterSubCategory string Nome della categoria di sottoclassificazione del contatore.
meterType string Nome del tipo di contatore
partNumber string Numero di parte associato al contatore
priceType string Il tipo di prezzo di un prodotto. Ad esempio, una risorsa di Azure con una tariffa con pagamento in base al consumo con priceType. Altri tipi di prezzo includono ReservedInstance e Piano di risparmio.
product string Nome del prodotto che determina un incremento dei costi.
productId string Identificatore univoco per il prodotto di cui viene utilizzato il contatore.
serviceFamily number Tipo di servizio di Azure. Ad esempio, Calcolo, Analytics e Sicurezza.
skuId string Identificatore univoco dello SKU
Termine di string Durata del piano di risparmio di Azure o del periodo di prenotazione: un anno o tre anni (P1Y o P3Y)
unitOfMeasure string Come viene misurato l'utilizzo per il servizio
unitPrice string Prezzo unitario al momento della fatturazione per un determinato prodotto o servizio, incluso qualsiasi sconto negoziato oltre al prezzo di mercato.

Per PriceType ReservedInstance, il prezzo unitario riflette il costo totale dell'impegno di uno o tre anni, inclusi gli sconti.

Nota: il prezzo unitario non è uguale al prezzo effettivo nei download dei dettagli di utilizzo, in caso di servizi con prezzi differenziati in base ai livelli.

Se i servizi sono prezzi multilivello, il prezzo effettivo è una tariffa combinata tra i livelli e non mostra un prezzo unitario specifico del livello. Il prezzo combinato o il prezzo effettivo è il prezzo netto per la quantità utilizzata che si estende tra più livelli (dove ogni livello ha un prezzo unitario specifico).

Contenuto correlato