Price Sheet - Download By Billing Profile

Riferimento

Servizio:: Cost Management

Versione API:: 2024-08-01

Ottiene un URL per scaricare il foglio prezzi del mese corrente per un profilo di fatturazione. L'operazione è supportata per gli account di fatturazione con tipo di contratto Microsoft Partner Agreement o Contratto del cliente Microsoft.

È possibile usare la nuova versione API 2023-09-01 per i periodi di fatturazione di gennaio 2023 e versioni successive. I prezzi delle istanze riservate di Azure sono disponibili solo tramite la nuova versione dell'API.

A causa della crescita del prodotto Azure, l'esperienza di download dell'elenco prezzi di Azure in questa versione di anteprima verrà aggiornata da un singolo file csv/json a un file ZIP contenente più file CSV/JSON, ognuno con dimensioni massime di 75 MB.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione

billingAccountName

path

True

string

ID che identifica in modo univoco un account di fatturazione.

Criterio di espressione regolare: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+):([A-Za-z0-9]+(-[A-Za-z0-9]+)+)_[0-9]{4}-[0-9]{2}-[0-9]{2}

billingProfileName

path

True

string

ID che identifica in modo univoco un profilo di fatturazione.

Criterio di espressione regolare: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+)

api-version

query

True

string

Versione dell'API da usare per questa operazione.

Risposte

Nome

Tipo

Descrizione

200 OK

PricesheetDownloadProperties

OK. La richiesta ha avuto esito positivo.

202 Accepted

Accettato.

Intestazioni

Location: string
Retry-After: string
OData-EntityId: string

Other Status Codes

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

PricesheetDownloadByBillingProfile

Esempio di richiesta

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

Risposta di esempio

Codice di stato:: 202

Location: https://management.azure.com:443/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/operationResults/45000000-0000-0000-0000-000000000000?sessiontoken=0:000000&api-version=2024-08-01&OperationType=PriceSheet
Retry-After: 60
OData-EntityId: 45000000-0000-0000-0000-000000000000

Codice di stato:: 200

{
  "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",
  "expiryTime": "2018-07-21T17:32:28Z"
}

Definizioni

Nome	Descrizione
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".
MCAPriceSheetProperties	Proprietà dell'elenco prezzi.
PricesheetDownloadProperties	URL per scaricare il report generato.

ErrorDetails

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

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.

MCAPriceSheetProperties

Proprietà dell'elenco prezzi.

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
billingAccountID	string	Identificatore univoco per l'account di fatturazione.
billingAccountName	string	Nome del profilo di fatturazione configurato per la ricezione delle fatture. I prezzi nell'elenco prezzi sono associati a questo profilo di fatturazione.
billingCurrency	string	Valuta in cui vengono registrati gli addebiti.
billingProfileId	string	Identificatore univoco per il profilo di fatturazione.
billingProfileName	string	Nome del profilo di fatturazione configurato per la ricezione delle fatture. I prezzi nell'elenco prezzi sono associati a questo profilo di fatturazione.
currency	string	Valuta in cui si riflettono tutti i prezzi.
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
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.
meterCategory	string	Nome della categoria di classificazione per il contatore. Ad esempio, servizi cloud, rete e così via.
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
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.
productOrderName	string	Nome del piano di prodotto acquistato. Indica se questi prezzi sono prezzi standard del piano di Azure, prezzi di sviluppo/test e così via. Attualmente non disponibile per i contatori di Terze parti e ReservedInstance di Azure.
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)
tierMinimumUnits	string	Definisce il limite inferiore dell'intervallo di livelli per cui vengono definiti i prezzi. Ad esempio, se l'intervallo è compreso tra 0 e 100, tierMinimumUnits sarà 0.
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 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).

PricesheetDownloadProperties

URL per scaricare il report generato.

Nome	Tipo	Descrizione
downloadFileProperties	MCAPriceSheetProperties	Proprietà nel file scaricato
downloadUrl	string	URL per scaricare il report generato.
expiryTime	string	Ora in cui l'URL del report diventa non valido/scade in FORMATO UTC, ad esempio 2020-12-08T05:55:59.4394737Z.