Price Sheet - Download By Billing Account

  • Riferimento
Servizio:
Cost Management
Versione API:
2023-11-01

Genera il foglio prezzi per il periodo di fatturazione specificato in modo asincrono in base all'ID registrazione. Questo vale per Enterprise Agreement clienti. È possibile usare la nuova versione dell'API 2023-09-01 all'indirizzo '/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download' per i periodi di fatturazione a gennaio 2023 in poi. Con un nuovo schema descritto di seguito, il nuovo elenco prezzi fornisce altre informazioni 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 dei prezzi precedenti dell'istanza riservata di Azure. 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 a un file ZIP contenente più file CSV, ognuno con dimensioni massime di 75 MB.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
billingAccountId
 path True

string

BillingAccount ID
billingPeriodName
 path True

string

Nome periodo di fatturazione.

Criterio di espressione regolare: ^[0-9]*$
api-version
 query True

string

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

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202311/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-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.
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 l'attesa del tempo specificato 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".
OperationStatus

Stato dell'operazione a esecuzione prolungata.
OperationStatusType

Stato dell'operazione a esecuzione prolungata.

EAPriceSheetProperties

Proprietà dell'elenco prezzi EA.

Nome Tipo Descrizione
basePrice

string

Il prezzo unitario al momento in cui il cliente effettua l'accesso o il 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
currencyCode

string

Valuta in cui è stato firmato il Enterprise Agreement
effectiveEndDate

string

Data di fine effettiva del periodo di fatturazione 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

Prezzo di listino corrente per un determinato prodotto o servizio. Questo prezzo è privo di trattative e si basa sul tipo di Contratto Microsoft.

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

Per Il piano di risparmio PriceType, 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 negoziazione, 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, 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

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)
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 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à utilizzata che si estende tra più livelli (dove ogni livello ha un prezzo unitario specifico).

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 l'attesa del tempo specificato 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.

OperationStatus

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

Scaricare la validità del collegamento.
status

OperationStatusType

Stato dell'operazione a esecuzione prolungata.

OperationStatusType

Stato dell'operazione a esecuzione prolungata.

Nome Tipo Descrizione
Completed

string

Failed

string

Running

string