Price Sheet - Download By Billing Profile

Referens

Tjänst:: Cost Management

API-version:: 2024-08-01

Hämtar en URL för att ladda ned den aktuella månadens prisuppsättning för en faktureringsprofil. Åtgärden stöds för faktureringskonton med avtalstypen Microsoft-partneravtal eller Microsoft-kundavtal.

Du kan använda den nya API-versionen 2023-09-01 för faktureringsperioder januari 2023 och senare. Priser för reserverade Instanser (RI) i Azure är endast tillgängliga via den nya versionen av API:et.

På grund av azure-produkttillväxt uppdateras nedladdningsupplevelsen för Azure-prisdokumentet i den här förhandsversionen från en enda csv/json-fil till en Zip-fil som innehåller flera csv/json-filer, var och en med maximal storlek på 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

URI-parametrar

Name I Obligatorisk Typ Description

billingAccountName

path

True

string

Det ID som unikt identifierar ett faktureringskonto.

Reguljärt uttrycksmönster: ([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

Det ID som unikt identifierar en faktureringsprofil.

Reguljärt uttrycksmönster: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+)

api-version

query

True

string

DEN API-version som ska användas för den här åtgärden.

Svar

Name

Typ

Description

200 OK

PricesheetDownloadProperties

OKEJ. Begäran har slutförts.

202 Accepted

Accepterad.

Sidhuvuden

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

Other Status Codes

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

PricesheetDownloadByBillingProfile

Exempelbegäran

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

Exempelsvar

Statuskod:: 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

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

Definitioner

Name	Description
ErrorDetails	Information om felet.
ErrorResponse	Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet. Några felsvar: 429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".
MCAPriceSheetProperties	Egenskaperna för prisdokumentet.
PricesheetDownloadProperties	URL:en för att ladda ned den genererade rapporten.

ErrorDetails

Information om felet.

Name	Typ	Description
code	string	Felkod.
message	string	Felmeddelande som anger varför åtgärden misslyckades.

ErrorResponse

Felsvaret anger att tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.

Några felsvar:

429 TooManyRequests – Begäran begränsas. Försök igen efter att ha väntat på den tid som anges i rubriken "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable – Tjänsten är inte tillgänglig för tillfället. Försök igen efter att ha väntat på den tid som anges i rubriken "Försök igen".

Name	Typ	Description
error	ErrorDetails	Information om felet.

MCAPriceSheetProperties

Egenskaperna för prisdokumentet.

Name	Typ	Description
basePrice	string	Enhetspriset vid den tidpunkt då kunden loggar in eller enhetspriset vid tidpunkten för servicemätarens GA-start om det är efter inloggning. Detta gäller för Enterprise-avtalsanvändare
billingAccountID	string	Unik identifierare för faktureringskontot.
billingAccountName	string	Namn på den faktureringsprofil som har konfigurerats för att ta emot fakturor. Priserna i prisdokumentet är associerade med den här faktureringsprofilen.
billingCurrency	string	Valuta där avgifter bokförs.
billingProfileId	string	Unik identifierare för faktureringsprofilen.
billingProfileName	string	Namn på den faktureringsprofil som har konfigurerats för att ta emot fakturor. Priserna i prisdokumentet är associerade med den här faktureringsprofilen.
currency	string	Valuta där alla priser återspeglas.
effectiveEndDate	string	Gällande slutdatum för faktureringsperioden för prisdokumentet
effectiveStartDate	string	Gällande startdatum för faktureringsperioden för prisdokumentet
marketPrice	string	Det aktuella listpriset för en viss produkt eller tjänst. Det här priset är utan förhandlingar och baseras på din Microsoft-avtalstyp. För PriceType-förbrukning återspeglas marknadspriset som betala per användning-pris. För PriceType Savings Plan återspeglar marknadspriset förmånen för sparplanen utöver betala per användning-priset för motsvarande åtagandeperiod. För PriceType ReservedInstance återspeglar marknadspriset det totala priset för åtagandet på 1 eller 3 år.
meterCategory	string	Namnet på mätarens klassificeringskategori. Till exempel molntjänster, nätverk osv.
meterName	string	Mätarens namn. Mätaren representerar den distributionsbara resursen för en Azure-tjänst.
meterRegion	string	Namnet på den Azure-region där mätaren för tjänsten är tillgänglig.
meterSubCategory	string	Namnet på mätarunderklassificeringskategorin.
meterType	string	Namnet på mätartypen
priceType	string	Pristyp för en produkt. Till exempel en Azure-resurs med ett betala per användning-pris med priceType som förbrukning. Andra pristyper är ReservedInstance och Sparplan.
product	string	Namnet på den produkt som ackumulerar avgifterna.
productId	string	Unik identifierare för den produkt vars mätare förbrukas.
productOrderName	string	Namnet på den köpta produktplanen. Anger om den här prissättningen är standardpriser för Azure-plan, Dev/Test-priser osv. För närvarande inte tillgänglig för Azure 3rd party och ReservedInstance meter.
serviceFamily	number	Typ av Azure-tjänst. Till exempel Compute, Analytics och Security.
skuId	string	Unik identifierare för SKU:n
term	string	Tidslängd för Azure Savings Plan eller Reservation term – ett år eller tre år (P1Y eller P3Y)
tierMinimumUnits	string	Definierar den lägre gränsen för nivåintervallet som priserna definieras för. Om intervallet till exempel är 0 till 100 skulle tierMinimumUnits vara 0.
unitOfMeasure	string	Hur användningen mäts för tjänsten
unitPrice	string	Priset per enhet vid tidpunkten för faktureringen för en viss produkt eller tjänst, inklusive eventuella förhandlade rabatter utöver marknadspriset. För PriceType ReservedInstance återspeglar enhetspriset den totala kostnaden för det 1- eller 3-åriga åtagandet, inklusive rabatter. Obs! Enhetspriset är inte detsamma som det effektiva priset i nedladdningar av användningsinformation när tjänsterna har olika priser på olika nivåer. Om tjänster har priser på flera nivåer är det effektiva priset en blandad hastighet mellan nivåerna och visar inte ett nivåspecifikt enhetspris. Det blandade priset eller det effektiva priset är nettopriset för den förbrukade kvantiteten som sträcker sig över flera nivåer (där varje nivå har ett specifikt enhetspris).

PricesheetDownloadProperties

URL:en för att ladda ned den genererade rapporten.

Name	Typ	Description
downloadFileProperties	MCAPriceSheetProperties	Egenskaperna i den nedladdade filen
downloadUrl	string	URL:en för att ladda ned den genererade rapporten.
expiryTime	string	Den tid då rapport-URL:en blir ogiltig/upphör att gälla i UTC, t.ex. 2020-12-08T05:55:59.4394737Z.