Price Sheet - Download By Billing Account

  • Reference
Služba:
Cost Management
Verze rozhraní API:
2024-08-01

Vygeneruje ceník poskytnutého fakturačního období asynchronně na základě ID registrace. Jedná se o zákazníky se smlouvou Enterprise.

Migrace na verzi 2024-08-01

S novým identifikátorem URI můžete použít verzi rozhraní API 2024-08-01:

'/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download'

S následujícím novým schématem poskytuje nová verze ceníku další informace a zahrnuje ceny za rezervované instance Azure (RI) pro aktuální fakturační období. Při zadávání nového fakturačního období doporučujeme stáhnout ceník Azure, pokud byste zachovali průběžný záznam o minulých cenách rezervované instance Azure (RI).

Ceník Azure EA je k dispozici pro fakturační období za posledních 13 měsíců. Pokud chcete požádat o ceník pro fakturační období starší než 13 měsíců, kontaktujte prosím podporu.

Prostředí pro stahování ceníků Azure bylo aktualizováno z jednoho souboru .csv na soubor ZIP obsahující více .csv souborů, z nichž každý má maximální velikost 75 MB. Verze z 11. 11. 2023 byla upgradována tak, aby používala metodu HTTP POST; podrobnosti najdete níže.

Všechny verze ceníku Microsoft.Consumption Azure – Stáhnout podle fakturačního účtu (včetně 2022-06-01, 10. 10. 2020– 10. 10. 2020– 10. 10. 2019, 10. 10. 2019– 01. června 2026) je naplánováno vyřazení z 1. června 2026 a po tomto datu už nebude podporováno.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
billingAccountId
 path True

string

ID fakturačního účtu
billingPeriodName
 path True

string

Název fakturačního období

Vzor regulárního výrazu: ^[0-9]*$
api-version
 query True

string

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

Odpovědi

Name Typ Description
200 OK

OperationStatus

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

Přijal.

Hlavičky

  • Location: string
  • Retry-After: string
Other Status Codes

ErrorResponse

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

EAPriceSheetForBillingPeriod

Ukázkový požadavek

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202311/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

Ukázková odpověď

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

Definice

Name Description
EAPriceSheetProperties

Vlastnosti ceníku EA. Vlastnosti podporované ve verzi 2024-08-01 jsou následující:
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í.
OperationStatus

Stav dlouhotrvající operace.
OperationStatusType

Stav dlouhotrvající operace.

EAPriceSheetProperties

Vlastnosti ceníku EA. Vlastnosti podporované ve verzi 2024-08-01 jsou následující:

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.
currencyCode

string

Měna, ve které byla podepsána smlouva Enterprise
effectiveEndDate

string

Platné koncové datum fakturačního období ceníku
effectiveStartDate

string

Platné počáteční datum fakturačního období ceníku
enrollmentNumber

string

Jedinečný identifikátor fakturačního účtu EA.
includedQuantity

string

Množství konkrétní služby, na kterou má zákazník EA nárok na využívání bez přírůstkových poplatků.
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.

Poznámka: U zákazníků se smlouvou ENTERPRISE bez vyjednávání se tržní cena může zobrazit zaokrouhlená na jinou desetinnou přesnost než jednotková cena.
meterCategory

string

Název kategorie klasifikace měřiče. Například cloudové služby, sítě atd.
meterId

string

Jedinečný identifikátor měřiče
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
offerId

string

Určuje nabídku Azure přidruženou k tomuto měřiči. [Další informace o nabídkách Azure] (https://azure.microsoft.com/en-us/support/legal/offer-details/)
partNumber

string

Číslo dílu přidružené k měřiči
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.
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)
unitOfMeasure

string

Jak se měří využití pro službu. Poznámka: Pole "Jednotka" bylo odebráno s verzí 2023-11-01 jako duplikát "UnitofMeasure", použijte pole "UnitOfMeasure".
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).

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ě.

OperationStatus

Stav dlouhotrvající operace.

Name Typ Description
properties.downloadFileProperties

EAPriceSheetProperties

Vlastnosti ve staženého souboru
properties.downloadUrl

string

Odkaz (url) ke stažení ceníku.
properties.validTill

string

Platnost odkazu ke stažení.
status

OperationStatusType

Stav dlouhotrvající operace.

OperationStatusType

Stav dlouhotrvající operace.

Name Typ Description
Completed

string

Failed

string

Running

string