Migrálás Nagyvállalati Szerződésről Microsoft Customer Agreement API-kra
Ez a cikk a Nagyvállalati Szerződés- (EA-) és a Microsoft Ügyfélszerződés- (MCA-) fiókok közötti különbségeket ismerteti az adatszerkezet, az API és az egyéb rendszer-integrációs szempontok tekintetében. A Cost Management mindkét fióktípushoz támogatja az API-kat. A folytatás előtt tekintse át a Microsoft Ügyfélszerződés számlázási fiókjának beállításával kapcsolatos szakaszt.
A meglévő EA-fiókkal rendelkező szervezeteknek át kell tekinteniük ezt a cikket, amikor beállítanak egy MCA-fiókot. Korábban az EA-fiókok megújításakor minimális energiaráfordításra volt szükség a régi regisztrációról egy újra való átálláshoz. Az MCA-fiókba való migrálás azonban további erőfeszítést igényel. A többletmunka az alapul szolgáló számlázási alrendszer változásainak köszönhető, amelyek minden költséghez kapcsolódó API-t és szolgáltatásajánlatot érintenek.
MCA API-k és integráció
Az MCA API-k és az új integráció a következőket teszik lehetővé:
- Az API-k teljes körű rendelkezésre állása a natív Azure API-kban.
- Több számla konfigurálása egyetlen számlázási fiókban.
- Egy kombinált API elérése Azure-szolgáltatáshasználathoz, a külső Marketplace-használathoz és Marketplace-beli vásárlásokhoz.
- A Cost Management használatával megtekintheti a számlázási profilok költségeit (a regisztrációkhoz hasonlóan).
- Új API-k érhetők el a költségek megjelenítéséhez, értesítések beállításához, amelyek jelzik, ha a költségek túllépik az előre megadott küszöbértékeket, illetve a nyers adatok automatikus exportálásához.
Migrálási ellenőrzőlista
A következő szempontok segítenek az MCA API-kra való átállásban.
- Ismerkedjen meg az új, Microsoft Ügyfélszerződéshez tartozó számlázási fiókkal.
- Határozza meg, hogy mely API-kat használja, és tekintse meg a következő szakaszban, hogy melyek lesznek lecserélve.
- Ismerkedjen meg az Azure Resource Manager REST API-kkal.
- Ha még nem használ Azure Resource Manager API-kat, regisztrálja az ügyfélalkalmazást a Microsoft Entra-azonosítóval.
- A Microsoft Entra alkalmazásregisztráció során létrehozott alkalmazásnak olvasási hozzáférést biztosíthat a számlázási fiókhoz a Hozzáférés-vezérlés (IAM) használatával.
- Frissítse a programozási kódot a Microsoft Entra-hitelesítés használatához.
- Frissítsen minden programkódot úgy, hogy az EA API-hívásokat MCA API-hívásokra cseréljék.
- Frissítse a hibakezelést az új hibakódok használatára.
- Tekintse át az egyéb integrációs ajánlatokat, például a Power BI-t más szükséges műveletekhez.
MCA API-kkal lecserélt EA API-k
Az EA API-k API-kulcsot használnak a hitelesítéshez és az engedélyezéshez. Az MCA API-k Microsoft Entra-hitelesítést használnak.
Feljegyzés
Minden Azure Enterprise Reporting API ki van állítva. A lehető leghamarabb át kell költöznie a Microsoft Cost Management API-kba .
| Cél | EA API | MCA API |
|---|---|---|
| Egyenleg és jóváírások | /balancesummary | Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae |
| Használat (JSON) | /usagedetails/usagedetailsbycustomdate | Költségrészlet-megoldás kiválasztása |
| Használat (CSV) | /usagedetails/download/usagedetails/submit | Költségrészlet-megoldás kiválasztása |
| Marketplace-használat (CSV) | /marketplacecharges/marketplacechargesbycustomdate | Költségrészlet-megoldás kiválasztása |
| Számlázási időszakok | /billingperiods | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Árlista | /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 |
| Foglalásvásárlások | /reservationcharges | Microsoft.Billing/billingAccounts/billingProfiles/transactions |
| Foglalási javaslatok | /SharedReservationRecommendations/SingleReservationRecommendations | Microsoft.Consumption/reservationRecommendations |
| Foglalás használata | /reservationdetails/reservationsummaries | Microsoft.Consumption/reservationDetailsMicrosoft.Consumption/reservationSummaries |
¹ Az Azure-szolgáltatás és a külső Marketplace-használat a Usage Details API-val érhető el.
A következő API-k érhetőek el az MCA számlázási fiókokhoz:
| Cél | Microsoft Customer Agreement (MCA) API |
|---|---|
| Számlázási fiókok² | Microsoft.Billing/billingAccounts |
| Számlázási profilok² | Microsoft.Billing/billingAccounts/billingProfiles |
| Számlaszakaszok² | Microsoft.Billing/billingAccounts/invoiceSections |
| Számlák | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Számlázási előfizetések | {scope}/billingSubscriptions |
A ² API-k olyan objektumlistákat adnak vissza, amelyek hatókörök, ahol a Cost Management-szolgáltatások az Azure Portalon és az API-kban működnek. A Cost Management-hatókörökkel kapcsolatos további információért tekintse meg A hatókörök ismertetése és használata című szakaszt.
Ha meglévő EA API-kat használ, frissítenie kell őket az MCA számlázási fiókjainak támogatásához. Az alábbi táblázat további integrációs változásokat mutat be:
| Cél | Régi ajánlat | Új ajánlat |
|---|---|---|
| Power BI | Microsoft Consumption Insights-tartalomcsomag és -összekötő | Azure Consumption Insights-összekötő |
API-k egyenleg és jóváírások lekérdezéséhez
A Get Balance Summary API a következők havi összegzését nyújtja:
- Egyenlegek
- Új vásárlások
- Az Azure Marketplace szolgáltatási díjai
- Kiigazítások
- A szolgáltatás kerettúllépési díjai
Az összes használati API-t olyan natív Azure API-k váltják fel, amelyek a Hitelesítéshez és engedélyezéshez Microsoft Entra-azonosítót használnak. További információ az Azure REST API-k hívásáról: Ismerkedés a REST-tel.
A Get Balance Summary API-t a Microsoft.Billing/billingAccounts/billingProfiles/availableBalance API váltja fel.
A rendelkezésre álló egyenleg lekérése az Available Balance API-val:
| Metódus | Kérés URI-ja |
|---|---|
| KAP | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview |
Költségek és használat lekérésére szolgáló API-k
A következő API-kkal az Azure-szolgáltatáshasználat, a külső Marketplace-használat és a Marketplace-beli vásárlások költségeinek napi lebontását kérheti le. A következő különálló API-k össze lettek vonva az Azure-szolgáltatások és a külső Marketplace-használat esetében. A régi API-kat az Export vagy a Cost Details API váltja fel. Az Önnek megfelelő megoldás kiválasztásához tekintse meg a Költség részleteinek kiválasztása című témakört. Mindkét megoldás ugyanazt a Cost Details-fájlt biztosítja, és piactéri vásárlásokat tartalmaz az adatokban, amelyek korábban csak az egyenleg összesítésében voltak láthatók.
- Get usage detail/download
- Get usage detail/submit
- Get usage detail/usagedetails
- Get usage detail/usagedetailsbycustomdate
- Get marketplace store charge/marketplacecharges
- Get marketplace store charge/marketplacechargesbycustomdate
Az exportálás és a Cost Details API, mint minden Cost Management API, több hatókörben is elérhető. A számlázott költségekhez (amelyet hagyományosan a regisztrációs szinten kapna) használja a számlázási profil hatókört. A Cost Management-hatókörökkel kapcsolatos további információért tekintse meg A hatókörök ismertetése és használata című szakaszt.
| Típus | Azonosító formátuma |
|---|---|
| Számlázási fiók | /Microsoft.Billing/billingAccounts/{billingAccountId} |
| Számlázási profil | /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} |
| Előfizetés | /subscriptions/{subscriptionId} |
| Erőforráscsoport | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName} |
Egyes tulajdonságnevek módosultak az Export and Cost Details API-val elérhető új Cost Details-adatkészletben. Az alábbi táblázatban láthatók a megfelelő tulajdonságok.
| Régi tulajdonság | Új tulajdonság | Jegyzetek |
|---|---|---|
| AccountId | n/a | Az előfizetés létrehozója nincs nyomon követve. Használja a következőt: invoiceSectionId (ugyanaz, mint a departmentId). |
| AccountNameAccountOwnerId és AccountOwnerEmail | n/a | Az előfizetés létrehozója nincs nyomon követve. Használja a következőt: invoiceSectionName (ugyanaz, mint a departmentName). |
| További információk (Info) | additionalInfo | |
| ChargesBilledSeparately | isAzureCreditEligible | A tulajdonságok ellentétek. Ha az isAzureCreditEnabled értéke igaz, akkor a ChargesBilledSeparately hamis. |
| ConsumedQuantity | mennyiség | |
| ConsumedService | consumedService | A pontos sztringértékek eltérhetnek. |
| ConsumedServiceId | Egyik sem | |
| CostCenter | costCenter | |
| Date és usageStartDate | dátum: | |
| Nap | Egyik sem | A napot elemzi a dátumból. |
| DepartmentId | invoiceSectionId | A pontos értékek eltérhetnek. |
| DepartmentName | invoiceSectionName | A pontos sztringértékek eltérhetnek. Szükség esetén konfigurálja úgy a számlázási szakaszokat, hogy megfeleljenek a részlegeknek. |
| ExtendedCost és Cost | costInBillingCurrency | |
| InstanceId | resourceId | |
| Ismétlődő költség | Egyik sem | |
| Hely | hely | |
| MeterCategory | meterCategory | A pontos sztringértékek eltérhetnek. |
| MeterId | meterId | A pontos sztringértékek eltérőek. |
| MeterName | meterName | A pontos sztringértékek eltérhetnek. |
| MeterRegion | meterRegion | A pontos sztringértékek eltérhetnek. |
| MeterSubCategory | meterSubCategory | A pontos sztringértékek eltérhetnek. |
| Month | Egyik sem | A hónapot elemzi a dátumból. |
| Ajánlat neve | Egyik sem | Használja a következőt: publisherName és productOrderName. |
| OfferID | Egyik sem | |
| Order Number | Egyik sem | |
| Cikkszám | Egyik sem | Használja meterId azonosítót és productOrderName nevet az árak egyedi azonosításához. |
| Plan Name | productOrderName | |
| Termék | Termék | |
| ProductId | productId | A pontos sztringértékek eltérőek. |
| Publisher Name | publisherName | |
| ResourceGroup | resourceGroupName | |
| ResourceGuid | meterId | A pontos sztringértékek eltérőek. |
| ResourceLocation | resourceLocation | |
| ResourceLocationId | Egyik sem | |
| ResourceRate | effectivePrice | |
| ServiceAdministratorId | n/a | |
| ServiceInfo1 | serviceInfo1 | |
| ServiceInfo2 | serviceInfo2 | |
| ServiceName | meterCategory | A pontos sztringértékek eltérhetnek. |
| ServiceTier | meterSubCategory | A pontos sztringértékek eltérhetnek. |
| StoreServiceIdentifier | n/a | |
| SubscriptionGuid | subscriptionId | |
| SubscriptionId | subscriptionId | |
| SubscriptionName | subscriptionName | |
| Címkék | címkét | A címkék tulajdonság a gyökérobjektumra vonatkozik, nem a beágyazott tulajdonságokra. |
| UnitOfMeasure | unitOfMeasure | A pontos sztringértékek eltérőek. |
| usageEndDate | dátum: | |
| Year | Egyik sem | Az évet elemzi a dátumból. |
| (új) | billingCurrency | A díjhoz használt pénznem. |
| (új) | billingProfileId | A számlázási profil (a regisztráció) egyedi azonosítója. |
| (új) | billingProfileName | A számlázási profil (a regisztráció) neve. |
| (új) | chargeType | Az Azure-szolgáltatáshasználat, a Marketplace-használat és a vásárlások megkülönböztetésére szolgál. |
| (új) | invoiceId | A számla egyedi azonosítója. Az aktuális, nyitott hónap esetében üres. |
| (új) | publisherType | A vásárlások közzétevőjének típusa. A használat esetében üres. |
| (új) | serviceFamily | A vásárlás típusa. A használat esetében üres. |
| (új) | servicePeriodEndDate | A megvásárolt szolgáltatás záródátuma. |
| (új) | servicePeriodStartDate | A megvásárolt szolgáltatás kezdődátuma. |
A Billing Periods API-t az Invoices API váltja fel
Az MCA számlázási fiókjai nem használnak számlázási időszakokat. Ehelyett a számlákkal szűkítik le a költségeket adott számlázási időszakokra. A Billing Periods API-t az Invoices API váltja fel. Az összes használati API-t olyan natív Azure API-k váltják fel, amelyek a Hitelesítéshez és engedélyezéshez Microsoft Entra-azonosítót használnak. További információ az Azure REST API-k hívásáról: Ismerkedés a REST-tel.
Számlák lekérése az Invoices API-val:
| Metódus | Kérés URI-ja |
|---|---|
| KAP | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview |
Price Sheet API-k
Ez a szakasz a meglévő Price Sheet API-kat ismerteti, és javaslatokat nyújt a Price Sheet API-ra való áttéréshez a Microsoft Ügyfélszerződés kapcsán. A Microsoft Ügyfélszerződések Price Sheet API-ját is tárgyalja, továbbá leírást ad az árlistákon szereplő mezőkről. Az Enterprise Get price sheet és az Enterprise Get billing periods API-kat a Microsoft Ügyfélszerződések Price Sheet API-ja váltja fel (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). Az új API támogatja a JSON és a CSV formátumokat is, aszinkron REST formátumokban. Az összes használati API-t olyan natív Azure API-k váltják fel, amelyek a Hitelesítéshez és engedélyezéshez Microsoft Entra-azonosítót használnak. További információ az Azure REST API-k hívásáról: Ismerkedés a REST-tel.
Billing Enterprise API-k
Régebben Billing Enterprise API-kat használt a vállalati regisztrációkhoz az árakkal és a számlázási időszakkal kapcsolatos információk lekéréséhez. A hitelesítés és az engedélyezés Microsoft Entra webes jogkivonatokat használt.
A megadott vállalati regisztráció érvényes árainak lekérése a Price Sheet és a Billing Period API-kkal:
| Metódus | Kérés URI-ja |
|---|---|
| KAP | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet |
| KAP | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet |
Price Sheet API Microsoft Ügyfélszerződésekhez
A Microsoft Ügyfélszerződések Price Sheet API-jával tekintheti meg az összes Azure- és Marketplace-felhasználási szolgáltatás árait. A számlázási profilhoz megjelenített árak a számlázási profilhoz tartozó összes előfizetésre érvényesek.
A Price Sheet API-val tekintheti meg az összes Azure-felhasználási szolgáltatás árlistaadatait CSV formátumban:
| Metódus | Kérés URI-ja |
|---|---|
| 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 |
A Price Sheet API-val tekintheti meg az összes Azure-felhasználási szolgáltatás árlistaadatait JSON formátumban:
| Metódus | Kérés URI-ja |
|---|---|
| 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 |
Az API a teljes fiókra vonatkozó árlistát adja vissza. Emellett azonban lekérheti az árlista tömör verzióját is PDF formátumban. Az összefoglalás egy adott számlához kiszámlázott Azure- és Marketplace-felhasználási szolgáltatásokat tartalmazza. A számlát az {invoiceId} azonosítja, amely ugyanaz, mint a Számlaösszesítő PDF-fájlokban látható Számlaszám. Íme egy példa.
Számlainformációk megtekintése a Price Sheet API-val CSV formátumban:
| Metódus | Kérés URI-ja |
|---|---|
| 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 |
Számlainformációk megtekintése a Price Sheet API-val JSON formátumban:
| Metódus | Kérés URI-ja |
|---|---|
| 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 |
Az aktuális nyitott számlázási ciklusban vagy szolgáltatási időszakban bármely Azure- vagy Marketplace-felhasználási szolgáltatás becsült árát is lekérheti.
A fogyasztási szolgáltatások becsült árainak megtekintése a Price Sheet API-val CSV formátumban:
| Metódus | Kérés URI-ja |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
A fogyasztási szolgáltatások becsült árainak megtekintése a Price Sheet API-val JSON formátumban:
| Metódus | Kérés URI-ja |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
A Microsoft Ügyfélszerződés Price Sheet API-jai aszinkron REST API-k. Az API-k válaszai módosultak a régi szinkron API-kéhoz képest. Az API-válasz törzse is módosult.
Régi válasz törzse
Itt látható egy példa a szinkron REST API-válaszra:
[
{
"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"
},
{
]
Új válasz törzse
Az API-k támogatják az Azure REST aszinkron formátumot. Ha meghívja az API-t a GET paranccsal, a következő választ kapja:
No Response Body
HTTP Status 202 Accepted
A következő fejlécek lesznek elküldve a kimenet helyével:
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}
Végezzen még egy GET-hívást a helyre irányulóan. A GET-hívásra adott válasz ugyanaz, amíg a művelet be nem fejeződik vagy hibás állapotot nem ér el. Ha befejeződött, a GET hívás helyére adott válasz a letöltési URL-címet adja vissza, mintha a műveletet egyszerre hajtották volna végre. Példa:
HTTP Status 200
{
"id": "providers/Microsoft.Consumption/operationresults/{operationId}",
"name": {operationId},
"type": “Microsoft.Consumption/operationResults",
"properties" : {
"downloadUrl": {urltoblob},
"validTill": "Date"
}
}
Az ügyfél is indíthat GET-hívást a következőhöz: Azure-AsyncOperation. A végpont a művelet állapotát adja vissza.
A következő táblázat a régebbi Enterprise Get Price Sheet API mezőit jeleníti meg. A Microsoft Ügyfélszerződések új árlistájában lévő megfelelő mezőket tartalmazza:
| Régi tulajdonság | Új tulajdonság | Jegyzetek |
|---|---|---|
| billingPeriodId | Nem alkalmazható | Nem alkalmazható. A Microsoft Ügyfélszerződések esetében a számla és a társított árlista felváltotta a billingPeriodId azonosítót. |
| meterId | meterId | |
| unitOfMeasure | unitOfMeasure | A pontos sztringértékek eltérhetnek. |
| includedQuantity | includedQuantity | A Microsoft Ügyfélszerződésekben szereplő szolgáltatásokra nem alkalmazható. |
| partNumber | Nem alkalmazható | Ehelyett használja a productOrderName (ugyanaz, mint az offerID) és a meterID kombinációját. |
| unitPrice | unitPrice | Az egységár a Microsoft Ügyfélszerződések keretében felhasznált szolgáltatásokra érvényes. |
| currencyCode | pricingCurrency | A Microsoft Ügyfélszerződések árai díjszabási pénznemben és számlázási pénznemben jelennek meg. A currencyCode a Microsoft Ügyfélszerződések pricingCurrency paraméterének felel meg. |
| offerID | productOrderName | Az OfferID helyett használhatja a productOrderName nevet, de az nem egyezik meg az OfferID azonosítóval. A productOrderName és a mérő határozza meg azonban a meterId és az OfferID azonosítóhoz kapcsolódó díjszabást a Microsoft Ügyfélszerződésekben a régebbi regisztrációk esetében. |
A Consumption Price Sheet API műveletei
Nagyvállalati szerződések esetén a Consumption Price Sheet API Get és Get By Billing Period műveleteit használta a subscriptionId azonosítón vagy számlázási időszakon alapuló hatókörhöz. Az API Azure Resource Manager-hitelesítést használ.
Hatókör árlista-információinak lekérése a Price Sheet API-val:
| Metódus | Kérés URI-ja |
|---|---|
| KAP | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Árlista-információk lekérése számlázási időszak alapján a Price Sheet API-val:
| Metódus | Kérés URI-ja |
|---|---|
| KAP | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
A fenti API-végpontok helyett a következőket használja a Microsoft Ügyfélszerződésekhez:
Price Sheet API Microsoft Ügyfélszerződésekhez (aszinkron REST API)
Ez az API Microsoft Ügyfélszerződés és extra attribútumokat biztosít.
Árlista számlázási fiókban lévő számlázási profil hatóköréhez
Ez az API a meglévő API. Frissítve lett, hogy megadja egy számlázási fiókban lévő számlázási profil árlistáját.
Árlista számlázási fiók szerinti hatókörhöz
Az árlista egy számlázási fiók regisztrációs hatókörében történő lekérésekor a rendszer Azure Resource Manager-hitelesítést használ.
Az árlista lekérése számlázási fiókban lévő regisztrációs fiók esetében:
| Metódus | Kérés URI-ja |
|---|---|
| KAP | /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
Microsoft Ügyfélszerződés esetén a következő szakaszban szereplő információkat használja. A Microsoft Ügyfélszerződésekhez használt tulajdonságokat biztosítja.
Árlista számlázási fiókban lévő számlázási profil hatóköréhez
A frissített Price Sheet by billing account API CSV formátumban kéri le az árlistát. Az árlista lekérése egy MCA számlázási profilra vonatkozó hatókörében:
| Metódus | Kérés URI-ja |
|---|---|
| KAP | /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 |
Az EA regisztrációs hatókörében az API-válasz és a tulajdonságok azonosak. A tulajdonságok ugyanazoknak az MCA-tulajdonságoknak felelnek meg.
Az Azure Resource Manager Price Sheet API-k régebbi tulajdonságai és a megfelelő új tulajdonságok a következő táblázatban szerepelnek.
| Régi Azure Resource Manager Price Sheet API-tulajdonság | Új Microsoft Customer Agreement Price Sheet API-tulajdonság | Leírás |
|---|---|---|
| Meter ID (Mérési azonosító) | meterId | A fogyasztásmérő egyedi azonosítója. Ugyanaz, mint a meterID. |
| Fogyasztásmérő neve | meterName | A fogyasztásmérő neve. A fogyasztásmérő az Azure-szolgáltatás üzembe helyezhető erőforrását jelöli. |
| Meter Category (Mérési kategória) | service | A fogyasztásmérő osztályozási kategóriájának neve. Ugyanaz, mint a Microsoft Ügyfélszerződés árlistáján szereplő szolgáltatás. A pontos sztringértékek eltérőek. |
| Meter Subcategory (Mérési alkategória) | meterSubCategory | A fogyasztásmérő osztályozási alkategóriájának neve. A szolgáltatás általános szolgáltatáskészlet-megkülönböztetésének besorolásán alapul. Például Basic SQL DB vagy Standard SQL DB. |
| Fogyasztásmérő régiója | meterRegion | |
| Unit (Egység) | Nem alkalmazható | A unitOfMeasure egységből elemezhető. |
| Mértékegység | unitOfMeasure | |
| Cikkszám | Nem alkalmazható | A cikkszám helyett a productOrderName és a MeterID segítségével azonosítsa egyedileg a számlázási profil árát. A mezők az MCA-számlák cikkszáma helyett az MCA-számlán szerepelnek. |
| Egységár | unitPrice | Microsoft Ügyfélszerződés egységára. |
| Pénznemkód | pricingCurrency | A Microsoft Ügyfélszerződések árai díjszabási pénznemben és számlázási pénznemben jelennek meg. A pénznemkód megegyezik a Microsoft Ügyfélszerződések pricingCurrency paraméterével. |
| Szolgáltatási keret | includedQuantity | A Microsoft Ügyfélszerződésekben szereplő szolgáltatásokra nem alkalmazható. Megjelenítés nulla értékekkel. |
| Ajánlat azonosítója | productOrderName | Az OfferID helyett használja a productOrderName nevet. Nem ugyanaz, mint az OfferID, de a productOrderName és a fogyasztásmérő határozza meg a Microsoft Ügyfélszerződések díjszabását. A régebbi regisztrációkban a meterId és az OfferID azonosítókhoz köthető. |
A Microsoft Ügyfélszerződések ára máshogy van meghatározva, mint a Nagyvállalati szerződéseké. A nagyvállalati regisztráció szolgáltatásainak ára a terméktől, cikkszámtól, fogyasztásmérőtől és ajánlattól függően egyedi. A Microsoft Ügyfélszerződések nem használnak cikkszámot.
Az Azure-felhasználási szolgáltatás a Microsoft Ügyfélszerződés részét képező ára a productOrderName és a meterID szerint egyedi. Ezek jelölik a szolgáltatás fogyasztásmérőjét és a termékcsomagot.
Az árlista és a Usage Details API-ban szereplő használat egyeztetéséhez a productOrderName és a meterID paramétereket használhatja.
A számlázásiprofil-tulajdonosi, közreműködői, olvasói és számlakezelői jogosultságokkal rendelkező felhasználók letölthetik az árlistát.
Az árlistán azon szolgáltatások árai szerepelnek, amelyeknek az ára használaton alapul. A szolgáltatások közé tartozik az Azure-felhasználás és a Marketplace-felhasználás. Az egyes szolgáltatási időszakok legutolsó ára zárolva lesz, és egyetlen szolgáltatási időszakban lesz alkalmazva a használatra. Az Azure-felhasználási szolgáltatások esetében a szolgáltatási időszak általában egy naptári hónap.
A Price Sheet API megszüntetett mezői
A következő mezők vagy nem érhetők el a Microsoft Ügyfélszerződés Price Sheet API-jaiban, vagy ugyanazokkal a mezőkkel rendelkeznek.
| Megszüntetett mező | Leírás |
|---|---|
| billingPeriodId | Nem alkalmazható. Az MCA InvoiceId paraméterének felel meg. |
| offerID | Nem alkalmazható. Az MCA productOrderName paraméterének felel meg. |
| meterCategory | Nem alkalmazható. Az MCA Service paraméterének felel meg. |
| egység | Nem alkalmazható. A unitOfMeasure egységből elemezhető. |
| currencyCode | Ugyanaz, mint az MCA pricingCurrency paramétere. |
| meterLocation | Ugyanaz, mint az MCA meterRegion paramétere. |
| partNumber | Nem alkalmazható, mert a cikkszám nem szerepel az MCA-számlákon. A cikkszám helyett használja a meterId és a productOrderName kombinációját az árak egyedi azonosításához. |
| totalIncludedQuantity | Nem alkalmazható. |
| pretaxStandardRate | Nem alkalmazható. |
Lecserélt Reservation Instance Charge API
A Reservation Instance Charge API-val számlázási tranzakciókat kérhet le a foglalásvásárlásokhoz. Az új API magában foglalja az összes vásárlást, beleértve a harmadik féltől származó Marketplace-ajánlatokat is. Az összes használati API-t olyan natív Azure API-k váltják fel, amelyek a Hitelesítéshez és engedélyezéshez Microsoft Entra-azonosítót használnak. További információ az Azure REST API-k hívásáról: Ismerkedés a REST-tel. A Reserved Instance Charge API-t a Transactions API váltja fel.
Foglalásvásárlások tranzakcióinak lekérése a Transactions API-val:
| Metódus | Kérés URI-ja |
|---|---|
| KAP | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview |
Lecserélt Recommendations API-k
A Reserved Instance Purchase Recommendations API-k az elmúlt 7, 30 vagy 60 nap virtuálisgép-használatáról nyújtanak információt. Az API-k a foglalásvásárlással kapcsolatos javaslatokat is biztosítanak. Ezek közé tartoznak például az alábbiak:
Az összes használati API-t olyan natív Azure API-k váltják fel, amelyek a Hitelesítéshez és engedélyezéshez Microsoft Entra-azonosítót használnak. További információ az Azure REST API-k hívásáról: Ismerkedés a REST-tel. A korábban felsorolt, foglalási javaslatokkal kapcsolatos API-k helyébe a Microsoft.Consumption/reservationRecommendations API lép.
Foglalási javaslatok lekérése a Reservation Recommendations API-val:
| Metódus | Kérés URI-ja |
|---|---|
| KAP | https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01 |
Lecserélt Reservation Usage API-k
A Reserved Instance Usage API-val kérheti le a regisztrációk foglaláshasználatát. Ha egy regisztrációban több fenntartott példány is van, ezzel az API-val lekérheti az összes fenntartottpéldány-vásárlással kapcsolatos használatot is.
Ezek közé tartoznak például az alábbiak:
Az összes használati API-t olyan natív Azure API-k váltják fel, amelyek a Hitelesítéshez és engedélyezéshez Microsoft Entra-azonosítót használnak. További információ az Azure REST API-k hívásáról: Ismerkedés a REST-tel. A korábban felsorolt, foglalási javaslatokkal kapcsolatos API-k helyébe a Microsoft.Consumption/reservationDetails és a Microsoft.Consumption/reservationSummaries API-k lépnek.
Foglalási részletek lekérése a Reservation Details API-val:
| Metódus | Kérés URI-ja |
|---|---|
| KAP | https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01 |
Foglalási összegzések lekérése a Reservation Summaries API-val:
| Metódus | Kérés URI-ja |
|---|---|
| KAP | https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01 |
Power BI-integráció
A költségek jelentéséhez a Power BI-t is használhatja. A Power BI Desktop Cost Management-összekötőjével hatékony, testre szabott jelentéseket hozhat létre, amelyek segítenek jobban megérteni az Azure-beli kiadásokat. A Cost Management-összekötő jelenleg Microsoft Ügyfélszerződés vagy Nagyvállalati Szerződés (EA) használatával támogatja az ügyfeleket.
Következő lépések
- Az Azure-beli költségek monitorozásáról és szabályozásáról a Cost Management dokumentációjában olvashat. Továbbá azt is megtudhatja, hogyan optimalizálhatja az erőforrás-használatot a Cost Managementtel.