Price Sheet - Download By Billing Account

Servizio:

Cost Management

Versione API:

2024-08-01

Genera la scheda prezzi per il periodo di fatturazione specificato in modo asincrono in base all'ID registrazione. Questo vale per i clienti con Contratto Enterprise.

Eseguire la migrazione alla versione 2024-08-01

È possibile usare la versione dell'API 2024-08-01 con il nuovo URI:

'/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download'

Con un nuovo schema dettagliato di seguito, la nuova versione dell'elenco prezzi fornisce informazioni aggiuntive e include i prezzi per le istanze riservate di Azure per il periodo di fatturazione corrente. È consigliabile scaricare un elenco prezzi di Azure per quando si immette un nuovo periodo di fatturazione se si mantiene un record continuativo dei prezzi delle istanze riservate di Azure precedenti.

L'elenco prezzi di Azure EA è disponibile per i periodi di fatturazione negli ultimi 13 mesi. Per richiedere un elenco prezzi per un periodo di fatturazione superiore a 13 mesi, contattare il supporto tecnico.

L'esperienza di download dell'elenco prezzi di Azure è stata aggiornata da un singolo file .csv a un file ZIP contenente più file .csv, ognuno con dimensioni massime di 75 MB. La versione 2023-11-01 è stata aggiornata per usare il metodo HTTP POST; i dettagli sono disponibili di seguito.

Tutte le versioni dell'elenco prezzi di Azure Microsoft.Consumption - Download by Billing Account (incluso 2022-06-01, 2021-10-01, 2020-01-01-preview, 2019-10-01, 2019-05-01) sono pianificati per essere ritirati il 01 giugno 2026 e non saranno più supportati dopo questa data.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
billingAccountId	path	True	string	BillingAccount ID
billingPeriodName	path	True	string pattern: ^[0-9]*$	Nome periodo di fatturazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	OperationStatus	OK. La richiesta ha avuto esito positivo.
202 Accepted		Accettato. Intestazioni Location: string Retry-After: string
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

EAPriceSheetForBillingPeriod

Esempio di richiesta

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202311/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

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

Definizioni

Nome	Descrizione
EAPriceSheetProperties	Proprietà dell'elenco prezzi EA. Le proprietà supportate con la versione 2024-08-01 sono le seguenti
ErrorDetails	Dettagli dell'errore.
ErrorResponse	La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore. Alcune risposte di errore: 429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".
OperationStatus	Stato dell'operazione a esecuzione prolungata.
OperationStatusType	Stato dell'operazione a esecuzione prolungata.

EAPriceSheetProperties

Object

Proprietà dell'elenco prezzi EA. Le proprietà supportate con la versione 2024-08-01 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. Questo è applicabile agli utenti con Contratto Enterprise
currencyCode	string	Valuta in cui è stato firmato il Contratto Enterprise
effectiveEndDate	string (date-time)	Data di fine effettiva del periodo di fatturazione dell'elenco prezzi
effectiveStartDate	string (date-time)	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	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 1 o 3 anni. Nota: per i clienti EA senza trattative, il prezzo di mercato può 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 e così via.
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
offerId	string	Determina l'offerta di Azure associata a questo contatore. [Altre informazioni sulle offerte di Azure] (https://azure.microsoft.com/en-us/support/legal/offer-details/)
partNumber	string	Numero di parte associato al contatore
priceType	string	Tipo di prezzo per 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 accumula gli addebiti.
productId	string	Identificatore univoco per il prodotto il cui contatore viene utilizzato.
serviceFamily	number	Tipo di servizio di Azure. Ad esempio, Calcolo, Analisi e Sicurezza.
skuId	string	Identificatore univoco dello SKU
term	string	Durata del piano di risparmio di Azure o del periodo di prenotazione: un anno o tre anni (P1Y o P3Y)
unitOfMeasure	string	Modalità di misurazione dell'utilizzo per il servizio. Nota: il campo "Unit" è stato rimosso con la versione 2023-11-01 come duplicato di "UnitofMeasure", usare il campo "UnitOfMeasure".
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 1 o 3 anni, inclusi gli sconti. Nota: il prezzo unitario non corrisponde al prezzo effettivo nei download dei dettagli di utilizzo quando i servizi hanno prezzi differenziali tra i livelli. Se i servizi hanno 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à consumata che si estende su più livelli (dove ogni livello ha un prezzo unitario specifico).

ErrorDetails

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

ErrorResponse

Object

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Alcune risposte di errore:

• 429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after".

• 503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".

Nome	Tipo	Descrizione
error	ErrorDetails	Dettagli dell'errore.

OperationStatus

Object

Stato dell'operazione a esecuzione prolungata.

Nome	Tipo	Descrizione
properties.downloadFileProperties	EAPriceSheetProperties	Proprietà nel file scaricato
properties.downloadUrl	string	Collegamento (URL) per scaricare la scheda prezzi.
properties.validTill	string (date-time)	Validità del collegamento per il download.
status	OperationStatusType	Stato dell'operazione a esecuzione prolungata.

OperationStatusType

Enumerazione

Stato dell'operazione a esecuzione prolungata.

Valore	Descrizione
Completed
Failed
Running