Migrace z rozhraní API podle smlouvy Enterprise (EA) na rozhraní API podle smlouvy se zákazníkem Microsoftu (MCA)
Tento článek vám pomůže pochopit rozdíly ve struktuře dat a rozhraních API a další odlišnosti v integraci systémů mezi účtem založeným na smlouvě Enterprise (EA) a účtem založeným na smlouvě se zákazníkem Microsoftu (MCA). Cost Management podporuje rozhraní API pro oba typy účtů. Než budete pokračovat, přečtěte si článek Vysvětlení fakturačních účtů pro smlouvu se zákazníkem Microsoftu.
Organizace se stávajícím účtem EA by si měly tento článek projít při nastavování účtu MCA. Už dříve bylo při obnovování účtu EA třeba provést několik kroků pro zajištění přechodu z původní registrace do nové. Šlo o minimální objem práce. Migrace na účet MCA ale vyžaduje další úsilí. Další úsilí je způsobené změnami základního subsystému fakturace, které ovlivňují všechna rozhraní API a nabídky služeb související s náklady.
Rozhraní API a integrace pro MCA
Rozhraní API pro MCA a nová integrace vám umožní:
- Zajistit plnou dostupnost rozhraní API prostřednictvím nativních rozhraní API v Azure
- Nakonfigurovat více faktur v rámci jednoho fakturačního účtu
- Přistupovat ke kombinovanému rozhraní API pro využití služeb Azure, využití webu Marketplace ve prospěch třetích stran a nákupy na webu Marketplace
- Zobrazení nákladů napříč fakturačními profily (stejné jako registrace) pomocí služby Cost Management
- Přistupovat k novým rozhraním API pro zobrazování nákladů, pro varování, když náklady překročí předdefinované prahové hodnoty, a pro automatický export nezpracovaných údajů
Kontrolní seznam pro migraci
Následující seznam vám usnadní přechod na rozhraní API podle MCA.
- Seznamte se s novým fakturačním účtem podle smlouvy se zákazníkem Microsoftu.
- Zjistěte, která rozhraní API používáte, a v následující části si ověřte, která z nich budou nahrazena.
- Seznamte se s rozhraními REST API pro Azure Resource Manager.
- Pokud ještě nepoužíváte rozhraní API Azure Resource Manageru, zaregistrujte svou klientskou aplikaci pomocí Microsoft Entra ID.
- Pomocí řízení přístupu (IAM) udělte aplikaci, která byla vytvořena během registrace aplikace Microsoft Entra, přístup ke čtení fakturačního účtu.
- Aktualizujte veškerý programovací kód tak, aby používal ověřování Microsoft Entra.
- Aktualizujte veškerý naprogramovaný kód tak, aby volání rozhraní API podle EA byla nahrazena voláními rozhraní API podle MCA.
- Aktualizujte zpracování chyb tak, aby se začaly používat nové kódy chyb.
- Zkontrolujte další nabídky integrace, jako je Power BI, a podívejte se na další potřebnou akci.
Rozhraní API podle EA nahrazená rozhraními API podle MCA
Rozhraní API podle EA používají pro ověření a autorizaci klíč rozhraní API. Rozhraní API MCA používají ověřování Microsoft Entra.
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.
| Účel | Rozhraní API podle EA | Rozhraní API podle MCA |
|---|---|---|
| Zůstatek a kredity | /balancesummary | Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae |
| Využití (JSON) | /usagedetails/usagedetailsbycustomdate | Volba řešení podrobností o nákladech |
| Využití (CSV) | /usagedetails/download/usagedetails/submit | Volba řešení podrobností o nákladech |
| Využití Marketplace (CSV) | /marketplacecharges/marketplacechargesbycustomdate | Volba řešení podrobností o nákladech |
| Fakturační období | /billingperiods | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Ceník | /pricesheet | Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json|csv Microsoft.Billing/billingAccounts/.../billingProfiles/.../invoices/... /pricesheet/default/download format=json|csv Microsoft.Billing/billingAccounts/.. /billingProfiles/.. /providers/Microsoft.Consumption/pricesheets/download |
| Nákupy rezervací | /reservationcharges | Microsoft.Billing/billingAccounts/billingProfiles/transactions |
| Doporučení pro rezervace | /SharedReservationRecommendations/SingleReservationRecommendations | Microsoft.Consumption/reservationRecommendations |
| Využití rezervací | /reservationdetails/reservationsummaries | Microsoft.Consumption/reservationDetailsMicrosoft.Consumption/reservationSummaries |
¹ Služba Azure a využití marketplace třetích stran jsou k dispozici s rozhraním API podrobnosti využití.
Pro fakturační účty MCA jsou k dispozici následující rozhraní API:
| Účel | Rozhraní API podle smlouvy se zákazníkem Microsoftu (MCA) |
|---|---|
| Fakturační účty² | Microsoft.Billing/billingAccounts |
| Fakturační profily² | Microsoft.Billing/billingAccounts/billingProfiles |
| Oddíly faktury² | Microsoft.Billing/billingAccounts/invoiceSections |
| Faktury | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Fakturace předplatných | {scope}/billingSubscriptions |
² Rozhraní API vrací seznamy objektů, které jsou obory, ve kterých fungují prostředí služby Cost Management na webu Azure Portal a rozhraní API. Další informace o oborech služby Cost Management najdete v tématu Vysvětlení a práce s rozsahy.
Pokud už používáte nějaká rozhraní API podle EA, musíte je aktualizovat tak, aby podporovala fakturační účty MCA. Následující tabulka uvádí další změny integrace:
| Účel | Původní nabídka | Nová nabídka |
|---|---|---|
| Power BI | Balíček obsahu a konektor Microsoft Consumption Insights | Konektor Azure Consumption Insights |
Rozhraní API pro načtení zůstatku a kreditů
Rozhraní API pro získání souhrnu zůstatků poskytuje měsíční shrnutí následujících údajů:
- Zůstatky
- Nové nákupy
- Poplatky za služby Azure Marketplace
- Opravy
- Poplatky za nadlimitní využití služby
Všechna rozhraní API consumption se nahrazují nativními rozhraními API Azure, která k ověřování a autorizaci používají ID Microsoft Entra. Další informace o volání rozhraní Azure REST API najdete v článku Začínáme s REST API.
Rozhraní API pro získání souhrnu zůstatků je nahrazeno rozhraním API Microsoft.Billing/billingAccounts/billingProfiles/availableBalance.
Jak získat dostupné zůstatky pomocí příslušného rozhraní API:
| metoda | Identifikátor URI žádosti |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview |
Rozhraní API pro získání nákladů a využití
Pomocí následujících rozhraní API získáte denní rozpis nákladů na využití služeb Azure a údaje o využití Marketplace ve prospěch třetích stran a dalších nákupech na webu Marketplace. Následující samostatná rozhraní API pro služby Azure a využití webu Marketplace ve prospěch třetích stran byla sloučena. Stará rozhraní API se nahrazují buď exportem , nebo rozhraním API pro podrobnosti nákladů. Pokud chcete zvolit řešení, které je pro vás správné, přečtěte si téma Volba řešení s podrobnostmi o nákladech. Obě řešení poskytují stejný soubor Podrobnosti nákladů a mají nákupy na marketplace v datech, které se dříve zobrazovaly pouze v souhrnu zůstatku k datu.
- Získat podrobnosti o využití/download
- Získat podrobnosti o využití/submit
- Získat podrobnosti o využití/usagedetails
- Získat podrobnosti o využití/usagedetailsbycustomdate
- Získat poplatky v obchodě Marketplace/marketplacecharges
- Marketplace/marketplacechargesbycustomdate
Exporty a rozhraní API Podrobnosti nákladů, stejně jako u všech rozhraní API služby Cost Management, jsou k dispozici v několika oborech. U fakturovaných nákladů, které byste tradičně získávali na úrovni registrace, použijte obor Fakturační profil. Další informace o oborech služby Cost Management najdete v tématu Vysvětlení a práce s rozsahy.
| Typ | Formát ID |
|---|---|
| Fakturační účet | /Microsoft.Billing/billingAccounts/{billingAccountId} |
| Fakturační profil | /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} |
| Předplatné | /subscriptions/{subscriptionId} |
| Skupina prostředků | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName} |
Některé názvy vlastností se změnily v nové datové sadě Podrobností o nákladech dostupné prostřednictvím rozhraní API exportů a podrobností nákladů. V následující tabulce jsou uvedeny odpovídající vlastnosti.
| Původní vlastnost | Nová vlastnost | Notes |
|---|---|---|
| AccountId | – | Tvůrce předplatného se nesleduje. Použijte invoiceSectionId (totéž jako departmentId). |
| AccountNameAccountOwnerId a AccountOwnerEmail | – | Tvůrce předplatného se nesleduje. Použijte invoiceSectionName (totéž jako departmentName). |
| AdditionalInfo | additionalInfo | |
| ChargesBilledSeparately | isAzureCreditEligible | Vlastnosti jsou opačné. Pokud má isAzureCreditEnabled hodnotu true, bude mít ChargesBilledSeparately hodnotu false. |
| ConsumedQuantity | množství. | |
| ConsumedService | consumedService | Přesné řetězcové hodnoty se můžou lišit. |
| ConsumedServiceId | Nic | |
| CostCenter | costCenter | |
| Date a usageStartDate | datum | |
| Den | Nic | Parsuje den z data. |
| DepartmentId | invoiceSectionId | Přesné hodnoty se liší. |
| DepartmentName | invoiceSectionName | Přesné řetězcové hodnoty se můžou lišit. Oddíly faktur můžete v případě potřeby nakonfigurovat podle oddělení. |
| ExtendedCost a Cost | costInBillingCurrency | |
| InstanceId | resourceId | |
| Is Recurring Charge | Nic | |
| Skladové místo | location | |
| MeterCategory | meterCategory | Přesné řetězcové hodnoty se můžou lišit. |
| ID měřiče | meterId | Přesné hodnoty se liší. |
| MeterName | meterName | Přesné řetězcové hodnoty se můžou lišit. |
| MeterRegion | meterRegion | Přesné řetězcové hodnoty se můžou lišit. |
| MeterSubCategory | meterSubCategory | Přesné řetězcové hodnoty se můžou lišit. |
| Month | Nic | Parsuje měsíc z data. |
| Název nabídky | Nic | Použijte publisherName a productOrderName. |
| OfferID | Nic | |
| Číslo objednávky | Nic | |
| PartNumber | Nic | Použijte meterId a productOrderName k jednoznačné identifikaci cen. |
| Název plánu | productOrderName | |
| Produkt | Produkt | |
| ID produktu | productId | Přesné hodnoty se liší. |
| Název vydavatele | publisherName | |
| ResourceGroup | resourceGroupName | |
| ResourceGuid | meterId | Přesné hodnoty se liší. |
| ResourceLocation | resourceLocation | |
| ResourceLocationId | Nic | |
| ResourceRate | effectivePrice | |
| ServiceAdministratorId | – | |
| ServiceInfo1 | serviceInfo1 | |
| ServiceInfo2 | serviceInfo2 | |
| ServiceName | meterCategory | Přesné řetězcové hodnoty se můžou lišit. |
| ServiceTier | meterSubCategory | Přesné řetězcové hodnoty se můžou lišit. |
| StoreServiceIdentifier | – | |
| SubscriptionGuid | subscriptionId | |
| SubscriptionId | subscriptionId | |
| SubscriptionName | subscriptionName | |
| Značky | značky | Vlastnost značek se vztahuje na kořenový objekt, ne na vlastnosti vnořené vlastnosti. |
| UnitOfMeasure | unitOfMeasure | Přesné hodnoty se liší. |
| usageEndDate | datum | |
| Year (Rok) | Nic | Parsuje rok z data. |
| (nové) | billingCurrency | Měna použitá pro poplatek |
| (nové) | billingProfileId | Jedinečný identifikátor fakturačního profilu (totéž jako registrace) |
| (nové) | billingProfileName | Název fakturačního profilu (totéž jako registrace) |
| (nové) | chargeType | Slouží k odlišení využití služeb Azure, využití webu Marketplace a nákupů. |
| (nové) | invoiceId | Jedinečné ID pro fakturu. Prázdné pro aktuální, otevřený měsíc. |
| (nové) | publisherType | Typ vydavatele u nákupů. Prázdné pro využití. |
| (nové) | serviceFamily | Typ nákupu. Prázdné pro využití. |
| (nové) | servicePeriodEndDate | Koncové datum nakupované služby. |
| (nové) | servicePeriodStartDate | Počáteční datum nakupované služby. |
Rozhraní API pro fakturační období nahrazeno rozhraním API pro faktury
Fakturační účty podle MCA nevyužívají klasická fakturační období. Místo toho na základě faktur rozdělují náklady na specifická fakturační období. Rozhraní API pro fakturační období je nahrazeno rozhraním API pro faktury. Všechna rozhraní API consumption se nahrazují nativními rozhraními API Azure, která k ověřování a autorizaci používají ID Microsoft Entra. Další informace o volání rozhraní Azure REST API najdete v článku Začínáme s REST API.
Jak získat faktury pomocí příslušného rozhraní API:
| metoda | Identifikátor URI žádosti |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview |
Rozhraní API pro ceníky
Tato část se zabývá existujícími rozhraními API pro ceníky a přináší doporučení pro přechod na rozhraní API pro ceníky podle smlouvy se zákazníkem Microsoftu. Popisuje také rozhraní API pro ceníky podle smlouvy se zákazníkem Microsoftu a vysvětluje význam polí v těchto cenících. Rozhraní API pro získání ceníku a pro získání fakturačních období podle smlouvy Enterprise jsou nahrazena rozhraním API pro ceníky podle smlouvy se zákazníkem Microsoftu (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). Pokud jde o asynchronní formáty REST, podporuje nové rozhraní API formáty JSON i CSV. Všechna rozhraní API consumption se nahrazují nativními rozhraními API Azure, která k ověřování a autorizaci používají ID Microsoft Entra. Další informace o volání rozhraní Azure REST API najdete v článku Začínáme s REST API.
Rozhraní API pro fakturaci podle smlouvy Enterprise
U registrací podle smlouvy Enterprise jste používali rozhraní API pro získávání informací o cenách a fakturačních obdobích. Ověřování a autorizace používaly webové tokeny Microsoft Entra.
Jak získat platné ceny pro zadanou registraci podle smlouvy Enterprise pomocí rozhraní API pro ceníky a fakturační období:
| metoda | Identifikátor URI žádosti |
|---|---|
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet |
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet |
Rozhraní API pro ceníky podle smlouvy se zákazníkem Microsoftu
Pomocí rozhraní API pro ceníky podle smlouvy se zákazníkem Microsoftu můžete zobrazit ceny pro všechny služby zahrnující spotřebu Azure a spotřebu Marketplace. Ceny zobrazené pro fakturační profil platí pro všechna předplatná, která spadají pod tento profil.
Pomocí rozhraní API pro ceníky si můžete všechny informace z ceníku týkající se spotřeby služeb Azure zobrazit ve formátu CSV:
| metoda | Identifikátor URI žádosti |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=csv |
Pomocí rozhraní API pro ceníky si můžete všechny informace z ceníku týkající se spotřeby služeb Azure zobrazit ve formátu JSON:
| metoda | Identifikátor URI žádosti |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=json |
Při použití tohoto rozhraní API získáte ceník pro celý účet. Můžete ale získat i zhuštěnou verzi ceníku ve formátu PDF. Tento souhrn zahrnuje služby spotřebu služeb Azure a spotřebu na webu Marketplace, která je vyúčtována na konkrétní faktuře. Faktura je identifikována číslem {invoiceId}, které se shoduje s číslem faktury zobrazeným v souborech PDF se souhrnem faktury. Následuje příklad.
Jak pomocí rozhraní API pro ceníky zobrazit informace o fakturaci ve formátu CSV:
| metoda | Identifikátor URI žádosti |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Jak pomocí rozhraní API pro ceníky zobrazit informace o fakturaci ve formátu JSON:
| metoda | Identifikátor URI žádosti |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/2909cffc-b0a2-5de1-bb7b-5d3383764184/billingProfiles/2dcffe0c-ee92-4265-8647-515b8fe7dc78/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
V aktuálním otevřeném fakturačním cyklu nebo období služby můžete také zobrazit odhadované ceny pro jakoukoli spotřebu služby Azure nebo spotřebu na webu Marketplace.
Jak pomocí rozhraní API pro ceníky zobrazit odhadované ceny pro spotřebu služeb ve formátu CSV:
| metoda | Identifikátor URI žádosti |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Jak pomocí rozhraní API pro ceníky zobrazit odhadované ceny pro spotřebu služeb ve formátu JSON:
| metoda | Identifikátor URI žádosti |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
Rozhraní API pro ceníky podle smlouvy se zákazníkem Microsoftu představují asynchronní rozhraní REST API. Oproti starším synchronním rozhraním API se u těchto rozhraní API změnily odpovědi. Změnilo se také tělo odpovědi rozhraní API.
Původní tělo odpovědi
Tady je příklad odpovědi synchronního rozhraní REST API:
[
{
"id": "enrollments/573549891/billingperiods/2016011/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"
},
{
]
Nové tělo odpovědi
Tato rozhraní API podporují asynchronní formát Azure REST. Pokud zavoláte rozhraní API pomocí příkazu GET, obdržíte následující odpověď:
No Response Body
HTTP Status 202 Accepted
Odešlou se následující hlavičky s umístěním výstupu:
Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Azure-AsyncOperation:https://managment.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Retry-After: 10
OData-EntityId: {operationId}
Nastavte jiný příkaz GET, aby volal do tohoto umístění. Odpověď na volání GET bude stejná, dokud operace nedosáhne stavu dokončení nebo selhání. Po dokončení vrátí odpověď na umístění volání GET adresu URL pro stažení, jako kdyby byla operace provedena ve stejnou dobu. Tady je příklad:
HTTP Status 200
{
"id": "providers/Microsoft.Consumption/operationresults/{operationId}",
"name": {operationId},
"type": “Microsoft.Consumption/operationResults",
"properties" : {
"downloadUrl": {urltoblob},
"validTill": "Date"
}
}
Klient může také provést volání GET pro Azure-AsyncOperation. Koncový bod vrátí stav operace.
Následující tabulka uvádí pole ve starším rozhraní API pro získání ceníku podle smlouvy Enterprise. Zahrnuje odpovídající pole v novém rozhraní pro ceníky podle smlouvy se zákazníkem Microsoftu:
| Původní vlastnost | Nová vlastnost | Notes |
|---|---|---|
| billingPeriodId | Neužívá se. | Nevztahuje se. U smlouvy se zákazníkem Microsoftu je koncept billingPeriodId nahrazen fakturou a přidruženým ceníkem. |
| meterId | meterId | |
| unitOfMeasure | unitOfMeasure | Přesné řetězcové hodnoty se můžou lišit. |
| includedQuantity | includedQuantity | Neplatí pro služby na základě smlouvy se zákazníkem Microsoftu. |
| partNumber | Neužívá se. | Místo toho použijte kombinaci productOrderName (totéž jako offerID) a meterID. |
| unitPrice | unitPrice | Jednotková cena se vztahuje na služby spotřebované na základě smlouvy se zákazníkem Microsoftu. |
| currencyCode | pricingCurrency | Smlouvy se zákazníkem Microsoftu zahrnují ceny uvedené v měně pro stanovení ceny i v měně fakturace. Položka currencyCode odpovídá položce pricingCurrency ve smlouvě se zákazníkem Microsoftu. |
| offerID | productOrderName | Místo hodnoty OfferId můžete použít productOrderName, ale není to totéž jako OfferId. U smluv se zákazníkem Microsoftu ale ceny určují položky productOrderName a meter, které odpovídají hodnotám meterId a OfferId ve starších registracích. |
Operace rozhraní API pro ceníky spotřeby
U smluv Enterprise jste v rozhraní API pro ceníky spotřeby používali operaci Get a operaci pro získání dat podle fakturačního období, a to pro obor stanovený hodnotou subscriptionId nebo fakturačním obdobím. Toto rozhraní API používá ověřování přes Azure Resource Management.
Jak pomocí rozhraní API pro ceníky získat ceníkové údaje pro konkrétní obor:
| metoda | Identifikátor URI žádosti |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Jak pomocí rozhraní API pro ceníky získat ceníkové údaje podle fakturačních období:
| metoda | Identifikátor URI žádosti |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Místo výše uvedených koncových bodů rozhraní API použijte u smluv se zákazníkem Microsoftu následující položky:
Rozhraní API pro ceníky podle smlouvy se zákazníkem Microsoftu (asynchronní rozhraní REST API)
Toto rozhraní API je určené pro Smlouva se zákazníkem Microsoftu a poskytuje další atributy.
Ceník pro obor Fakturační profil v rámci fakturačního účtu
Toto je existující rozhraní API. Bylo aktualizováno, aby poskytovalo ceník pro fakturační profil v rámci fakturačního účtu.
Ceník pro určitý obor podle fakturačního účtu
V případě získávání ceníku pro obor Registrace v rámci fakturačního účtu se používá ověřování přes Azure Resource Manager.
Jak získat ceník na úrovni registračního účtu v rámci fakturačního účtu:
| metoda | Identifikátor URI žádosti |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
V případě smlouvy se zákazníkem Microsoftu uplatněte informace uvedené v následující části. Uvádí vlastnosti polí používané pro smlouvy se zákazníkem Microsoftu.
Ceník pro obor Fakturační profil v rámci fakturačního účtu
Aktualizované rozhraní API pro ceník podle fakturačních účtů načítá ceník ve formátu CSV. Jak získat ceník pro obor Fakturační profil pro MCA:
| metoda | Identifikátor URI žádosti |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/28ae4b7f-41bb-581e-9fa4-8270c857aa5f/billingProfiles/ef37facb-cd6f-437a-9261-65df15b673f9/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
V oboru registrace EA se odpověď rozhraní API a vlastnosti shodují. Vlastnosti odpovídají stejným vlastnostem MCA.
Starší vlastnosti z rozhraní API pro ceníky v rámci Azure Resource Manageru a odpovídající nové vlastnosti najdete v následující tabulce.
| Původní vlastnost rozhraní API pro ceníky v rámci Azure Resource Manageru | Nová vlastnost rozhraní API pro ceníky podle smlouvy se zákazníkem Microsoftu | Popis |
|---|---|---|
| ID měření | meterId | Jedinečný identifikátor měřiče Stejné jako meterID. |
| Název měřiče | meterName | Název měřiče. Měřič představuje nasaditelný prostředek služby Azure. |
| Kategorie měřiče | service | Název klasifikační kategorie měřiče. Totéž jako služba v ceníku v rámci smlouvy se zákazníkem Microsoftu. Přesné hodnoty se liší. |
| Podkategorie měřiče | meterSubCategory | Název kategorie dílčí klasifikace měřiče. Na základě klasifikace pro rozlišení sad funkcí na nejvyšší úrovni v rámci služby. Například SQL Database úrovně Basic oproti SQL Database úrovně Standard. |
| Oblast měřiče | meterRegion | |
| Unit | Neužívá se. | Lze parsovat z položky unitOfMeasure. |
| Měrná jednotka | unitOfMeasure | |
| Číslo části | Neužívá se. | Místo čísla části se k jedinečné identifikaci ceny pro fakturační profil používají položky productOrderName a MeterID. Tato pole jsou na faktuře MCA uvedena místo čísla části. |
| Jedn. cena | unitPrice | Jednotková cena podle smlouvy se zákazníkem Microsoftu |
| Kód měny | pricingCurrency | Smlouvy se zákazníkem Microsoftu uvádějí ceny v měně pro stanovení ceny i v měně fakturace. Kód měny se shoduje s položkou pricingCurrency ve smlouvě se zákazníkem Microsoftu. |
| Zahrnuté množství | includedQuantity | Neplatí pro služby v rámci smlouvy se zákazníkem Microsoftu. Zobrazí se i s nulovými hodnotami. |
| ID nabídky | productOrderName | Místo hodnoty OfferId se používá productOrderName. Neshoduje se s hodnotou OfferID, ale u smluv se zákazníkem Microsoftu ceny určují položky productOrderName a meter. Ty odpovídají hodnotám meterId a OfferId ve starších registracích. |
Cena u smluv se zákazníkem Microsoftu je definována jinak než u smluv Enterprise. Cena za služby v registraci podle smlouvy Enterprise jedinečně vyplývá z produktu, čísla části, měřiče a nabídky. Číslo části se u smluv se zákazníkem Microsoftu nepoužívá.
Cena za spotřebu služeb Azure, která spadá pod smlouvu se zákazníkem Microsoftu, jedinečně vyplývá z hodnot productOrderName a meterID. Ty představují měřič služby a plán produktu.
Pokud chcete porovnat ceník a využití v rozhraní API pro podrobnosti o využití, můžete použít hodnoty productOrderName a meterID.
Ceník si můžou stáhnout uživatelé s oprávněním vlastníka fakturačního profilu, přispěvatele, čtenáře a správce fakturace.
Ceník zahrnuje ceny služeb účtovaných podle využití. Patří sem spotřeba služeb Azure a spotřeba na webu Marketplace. Nejaktuálnější cena na konci každého období je uzamčená a vztahuje se na využití v rámci jednoho období. Pokud jde o spotřebu služeb Azure, účtuje se obvykle po kalendářních měsících.
Vyřazená pole v rozhraní API pro ceníky
Následující pole buď nejsou v rozhraních API pro ceníky podle smlouvy se zákazníkem Microsoftu k dispozici, nebo je nahradila obdobná pole.
| Vyřazené pole | Popis |
|---|---|
| billingPeriodId | Neužívá se. Odpovídá položce InvoiceId u MCA. |
| offerID | Nevztahuje se. Odpovídá položce productOrderName u MCA. |
| meterCategory | Nevztahuje se. Odpovídá položce Service u MCA. |
| unit | Nevztahuje se. Lze parsovat z položky unitOfMeasure. |
| currencyCode | Totéž jako položka pricingCurrency u MCA. |
| meterLocation | Totéž jako položka meterRegion u MCA. |
| partNumber | Neužívá se, protože číslo části se na fakturách podle MCA neuvádí. Místo čísla části se k jedinečné identifikaci cen používá kombinace položek meterID a productOrderName. |
| totalIncludedQuantity | Nevztahuje se. |
| pretaxStandardRate | Nevztahuje se. |
Nahrazení rozhraní API pro poplatky za rezervované instance
Fakturované transakce spojené s nákupy rezervací můžete získat pomocí rozhraní API pro poplatky za rezervované instance. Nové rozhraní API zahrnuje všechny nákupy, včetně nabídek třetích stran na webu Marketplace. Všechna rozhraní API consumption se nahrazují nativními rozhraními API Azure, která k ověřování a autorizaci používají ID Microsoft Entra. Další informace o volání rozhraní Azure REST API najdete v článku Začínáme s REST API. Rozhraní API pro poplatky za rezervované instance je nahrazeno rozhraním API pro transakce.
Jak získat transakce spojené s nákupem rezervací pomocí rozhraní API pro transakce:
| metoda | Identifikátor URI žádosti |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview |
Nahrazení rozhraní API pro doporučení
Rozhraní API pro doporučení k nákupu rezervovaných instancí poskytují údaje o využití virtuálních počítačů za posledních 7, 30 nebo 60 dnů. Rozhraní API také nabízejí doporučení k nákupu rezervací. Patří sem:
- Rozhraní API pro doporučení sdílených rezervovaných instancí
- Rozhraní API pro doporučení jednotlivých rezervovaných instancí
Všechna rozhraní API consumption se nahrazují nativními rozhraními API Azure, která k ověřování a autorizaci používají ID Microsoft Entra. Další informace o volání rozhraní Azure REST API najdete v článku Začínáme s REST API. Výše uvedená rozhraní API pro doporučení rezervací jsou nahrazena rozhraním API Microsoft.Consumption/reservationRecommendations.
Jak získat doporučení rezervací pomocí příslušného rozhraní API:
| metoda | Identifikátor URI žádosti |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01 |
Nahrazení rozhraní API pro využití rezervací
Údaje o využití rezervací v registraci můžete získat pomocí rozhraní API pro využití rezervovaných instancí. Pokud je v registraci více než jedna rezervovaná instance, můžete pomocí tohoto rozhraní API získat i údaje o využití všech nákupů rezervovaných instancí.
Patří sem:
Všechna rozhraní API consumption se nahrazují nativními rozhraními API Azure, která k ověřování a autorizaci používají ID Microsoft Entra. Další informace o volání rozhraní Azure REST API najdete v článku Začínáme s REST API. Výše uvedená rozhraní API pro doporučení rezervací jsou nahrazena rozhraním API Microsoft.Consumption/reservationDetails a Microsoft.Consumption/reservationSummaries.
Jak získat podrobnosti o rezervacích pomocí příslušného rozhraní API:
| metoda | Identifikátor URI žádosti |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01 |
Jak získat souhrny rezervací pomocí příslušného rozhraní API:
| metoda | Identifikátor URI žádosti |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01 |
Integrace Power BI
Pro vykazování nákladů můžete použít také Power BI. Konektor Cost Management pro Power BI Desktop můžete použít k vytváření výkonných přizpůsobených sestav, které vám pomůžou lépe porozumět výdajům na Azure. Konektor Cost Management aktuálně podporuje zákazníky s Smlouva se zákazníkem Microsoftu nebo smlouva Enterprise (EA).
Další kroky
- Další informace o tom, jak monitorovat a řídit výdaje v Azure, najdete v dokumentaci ke službě Cost Management. Najdete tam také informace o optimalizaci využití prostředků pomocí služby Cost Management.