Migrace z rozhraní API ceníku EA
Zákazníci EA, kteří dříve používali rozhraní API pro podnikové generování sestav consumption.azure.com k získání ceníku, musí migrovat na náhradní rozhraní API Azure Resource Manageru. Následující pokyny vám pomůžou migrovat a také popisují všechny rozdíly mezi starým rozhraním API a novým rozhraním API.
Poznámka:
Všechna rozhraní API pro podnikové vytváření sestav Azure se vyřadí z důchodu. Co nejdříve byste měli migrovat na rozhraní API služby Microsoft Cost Management.
Přiřazení oprávnění instančnímu objektu pro volání rozhraní API
Před voláním rozhraní API je potřeba nakonfigurovat instanční objekt (SPN) se správným oprávněním. Instanční objekt použijete k volání rozhraní API. Další informace najdete v tématu Přiřazení oprávnění k rozhraním API služby Cost Management.
Volání rozhraní API ceníku
Rozhraní API ceníku generuje ceník asynchronně a vytvoří soubor, který stáhnete.
Při volání nového rozhraní API ceníku použijte následující identifikátory URI požadavků:
Podporované požadavky
Rozhraní API můžete volat pomocí následujícího oboru:
Registrace: providers/Microsoft.Billing/billingAccounts/{billingAccountId}
Stažení podle fakturačního účtu pro zadané fakturační období
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01
Požadavek POST vrátí umístění pro dotazování stavu generování sestavy, jak je uvedeno v následující odpovědi:
Ukázková odpověď
Stavový kód: 202
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?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"
}
}
Ukázkový požadavek pro dotaz na stav generování sestav
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01
Změny textu odpovědi
[
{
"id": "enrollments/57354989/billingperiods/201601/products/343/pricesheets",
"billingPeriodId": "201704",
"meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
"meterName": "A1 VM",
"unitOfMeasure": "100 Hours",
"includedQuantity": 0,
"partNumber": "N7H-00015",
"unitPrice": 0.00,
"currencyCode": "USD"
},
{
"id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
"billingPeriodId": "201404",
"meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
"meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
"unitOfMeasure": "100 GB",
"includedQuantity": 0,
"partNumber": "N9H-00402",
"unitPrice": 0.00,
"currencyCode": "USD"
},
...
]
Nové změny odpovědí
Vlastnosti ceníku jsou následující:
| Název | Typ | Popis |
|---|---|---|
| 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í. Platí pro uživatele smlouva Enterprise |
| currencyCode | string | Měna, ve které byl smlouva Enterprise podepsán |
| 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. Cena priceType ReservedInstance odráží celkovou cenu závazku za jeden nebo tři roky. Poznámka: U zákazníků se smlouvou ENTERPRISE bez vyjednávání se tržní cena může zdát zaokrouhlená na jinou desetinnou přesnost než jednotková cena. |
| meterCategory | string | Název klasifikační kategorie 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 dílčí klasifikace měřiče. |
| meterType | string | Název typu měřiče |
| 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č se spotřebovává |
| serviceFamily | Číslo | Typ služby Azure Například Compute, Analytics a Security. |
| skuId | string | Jedinečný identifikátor skladové položky |
| Termín | 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 |
| 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. V případě ceny PriceType ReservedInstance se jednotková cena odráží celkové náklady na jeden nebo tříletý 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 jsou služby vícevrstvé ceny, efektivní cena je smíšená sazba napříč úrovněmi a nezobrazuje jednotkovou cenu specifickou pro jednotlivé úrovně. Smíšená neboli platná cena je čistá cena za spotřebované množství napříč různými úrovněmi (kde pro každou úroveň platí jiná jednotková cena). |