Price Sheet - Download By Billing Profile

Reference

Služba:: Cost Management

Verze rozhraní API:: 2024-08-01

Získá adresu URL pro stažení ceníku aktuálního měsíce pro fakturační profil. Operace se podporuje u fakturačních účtů s typem Smlouvy s partnerem Microsoftu nebo Smlouvou se zákazníkem Microsoftu.

Novou verzi rozhraní API z 9. 9. 2023 můžete použít pro fakturační období leden 2023 a vyšší. Ceny rezervované instance Azure (RI) jsou dostupné pouze prostřednictvím nové verze rozhraní API.

Vzhledem k růstu produktů Azure se prostředí pro stahování ceníků Azure v této verzi Preview aktualizuje z jednoho souboru CSV/JSON na soubor ZIP obsahující více souborů CSV/JSON, z nichž každý má maximální velikost 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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description

billingAccountName

path

True

string

ID, které jednoznačně identifikuje fakturační účet.

Vzor regulárního výrazu: ([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, které jednoznačně identifikuje fakturační profil.

Vzor regulárního výrazu: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+)

api-version

query

True

string

Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name

Typ

Description

200 OK

PricesheetDownloadProperties

OK. Požadavek byl úspěšný.

202 Accepted

Přijal.

Hlavičky

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

Other Status Codes

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

PricesheetDownloadByBillingProfile

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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

Stavový kód:: 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"
}

Definice

Name	Description
ErrorDetails	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě. Některé chybové odpovědi: 429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after. 503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění.
MCAPriceSheetProperties	Vlastnosti ceníku.
PricesheetDownloadProperties	Adresa URL pro stažení vygenerované sestavy.

ErrorDetails

Podrobnosti o chybě.

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva označující, proč operace selhala.

ErrorResponse

Chybová odpověď značí, že služba nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě.

Některé chybové odpovědi:

429 TooManyRequests – Požadavek je omezený. Opakujte akci po čekání na dobu uvedenou v hlavičce x-ms-ratelimit-microsoft.consumption-retry-after.
503 ServiceUnavailable – Služba je dočasně nedostupná. Opakujte akci po čekání na dobu uvedenou v hlavičce Opakovat až po spuštění.

Name	Typ	Description
error	ErrorDetails	Podrobnosti o chybě.

MCAPriceSheetProperties

Vlastnosti ceníku.

Name	Typ	Description
basePrice	string	Jednotková cena v okamžiku, kdy se zákazník přihlásí, nebo jednotkovou cenu v době spuštění ga měřiče služby, pokud je po přihlášení. To platí pro uživatele se smlouvou Enterprise.
billingAccountID	string	Jedinečný identifikátor fakturačního účtu
billingAccountName	string	Název fakturačního profilu, který je nastavený tak, aby přijímal faktury. Ceny v ceníku jsou přidružené k tomuto fakturačnímu profilu.
billingCurrency	string	Měna, ve které se poplatky publikují.
billingProfileId	string	Jedinečný identifikátor fakturačního profilu.
billingProfileName	string	Název fakturačního profilu, který je nastavený tak, aby přijímal faktury. Ceny v ceníku jsou přidružené k tomuto fakturačnímu profilu.
currency	string	Měna, ve které se projeví všechny ceny.
effectiveEndDate	string	Platné koncové datum fakturačního období ceníku
effectiveStartDate	string	Platné počáteční datum fakturačního období ceníku
marketPrice	string	Aktuální ceníková cena pro daný produkt nebo službu. Tato cena je bez jakýchkoli jednání a je založená na typu vaší smlouvy s Microsoftem. U ceny PriceType Consumption se tržní cena odráží jako cena průběžných plateb. U plánu PriceType Savings Plan odráží tržní cena výhodu plánu Úspory nad cenou průběžných plateb za odpovídající období závazku. U ceny PriceType ReservedInstance se tržní cena odráží celkovou cenu 1 nebo 3letého závazku.
meterCategory	string	Název kategorie klasifikace měřiče. Například cloudové služby, sítě atd.
meterName	string	Název měřiče. Měřič představuje nasaditelný prostředek služby Azure.
meterRegion	string	Název oblasti Azure, ve které je měřič služby dostupný.
meterSubCategory	string	Název kategorie podtřídy měřiče.
meterType	string	Název typu měřiče
priceType	string	Typ ceny produktu. Například prostředek Azure s průběžnými platbami s hodnotou priceType jako Consumption. Mezi další cenové typy patří ReservedInstance a Savings Plan.
product	string	Název produktu, za který se účtují poplatky.
productId	string	Jedinečný identifikátor produktu, jehož měřič je spotřebován.
productOrderName	string	Název zakoupeného plánu produktu. Označuje, jestli se jedná o ceny standardních plánů Azure, ceny pro vývoj/testování atd. V současné době není k dispozici pro měřiče Azure třetích stran a ReservedInstance.
serviceFamily	number	Typ služby Azure Například Compute, Analytics a Security.
skuId	string	Jedinečný identifikátor skladové položky
term	string	Délka období pro plán Úspory v Azure nebo období rezervace – jeden rok nebo tři roky (P1Y nebo P3Y)
tierMinimumUnits	string	Definuje dolní mez rozsahu vrstev, pro který jsou definovány ceny. Pokud je například rozsah 0 až 100, úroveňMinimumUnits by byla 0.
unitOfMeasure	string	Jak se měří využití pro službu
unitPrice	string	Cena za jednotku v době fakturace daného produktu nebo služby včetně jakýchkoli vyjednaných slev nad tržní cenou. U ceny PriceType ReservedInstance se jednotková cena odráží celkové náklady na 1 nebo 3letý závazek včetně slev. Poznámka: Jednotková cena není stejná jako efektivní cena v podrobnostech o využití ke stažení, pokud služby mají rozdílové ceny napříč úrovněmi. Pokud mají služby vícevrstvé ceny, efektivní cena je smíšená sazba napříč úrovněmi a nezobrazuje jednotkovou cenu specifickou pro jednotlivé úrovně. Smíšená cena nebo platná cena je čistá cena za spotřebované množství přes více úrovní (kde každá úroveň má určitou jednotkovou cenu).

PricesheetDownloadProperties

Adresa URL pro stažení vygenerované sestavy.

Name	Typ	Description
downloadFileProperties	MCAPriceSheetProperties	Vlastnosti ve staženého souboru
downloadUrl	string	Adresa URL pro stažení vygenerované sestavy.
expiryTime	string	Čas, kdy bude adresa URL sestavy neplatná nebo vyprší v UTC, například 2020-12-08T05:55:59.4394737Z.