Price Sheet - Download By Billing Profile

  • Riferimento
Servizio:
Cost Management
Versione API:
2023-11-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 Contratto Microsoft Partner o Contratto del cliente Microsoft.

È possibile usare la nuova versione api 2023-09-01 per i periodi di fatturazione di gennaio 2023. I prezzi dell'istanza riservata di Azure (RI) sono disponibili solo tramite la nuova versione dell'API.

A causa della crescita del prodotto di Azure, l'esperienza di download del foglio 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=2023-11-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

ErrorResponse

Risposta di errore che descrive perché 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

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=2023-11-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=2023-11-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

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 l'attesa dell'ora specificata nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after".

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

Proprietà del foglio 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 perché l'operazione non è riuscita.

ErrorResponse

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 l'attesa dell'ora specificata nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after".

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

Nome Tipo Descrizione
error

ErrorDetails

Dettagli dell'errore.

MCAPriceSheetProperties

Proprietà del foglio prezzi.

Nome Tipo Descrizione
basePrice

string

Prezzo unitario al momento dell'accesso o del prezzo unitario al momento dell'avvio della disponibilità generale del contatore del servizio se è dopo l'accesso.

Questo è applicabile per gli utenti di Enterprise Agreement
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 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 sono riflessi tutti i prezzi.
effectiveEndDate

string

Data di fine effettiva del periodo di fatturazione del foglio prezzi
effectiveStartDate

string

Data di inizio effettiva del periodo di fatturazione del foglio prezzi
marketPrice

string

Prezzo di listino corrente per un determinato prodotto o servizio. Questo prezzo è senza negoziati e si basa sul tipo di contratto Microsoft.

Per PriceType Consumo, il prezzo del mercato viene riflesso come prezzo con pagamento in base al consumo.

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

Per PriceType ReservedInstance, il prezzo del 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, ecc.
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 di cui viene utilizzato il contatore.
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 minimo dell'intervallo di livelli per il quale vengono definiti i prezzi. Se, ad esempio, l'intervallo è compreso tra 0 e 100, tierMinimumUnits sarà 0.
unitOfMeasure

string

Come viene misurato l'utilizzo per il servizio
unitPrice

string

Prezzo per unità al momento della fatturazione per un determinato prodotto o servizio, incluso qualsiasi sconto negoziato in cima 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 è uguale al prezzo effettivo nei dettagli di utilizzo download quando i servizi hanno prezzi differenziali tra 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à utilizzata che si estende tra 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 UTC, ad esempio 2020-12-08T05:55:59.4394737Z.