Migrálás EA Usage Details API-kból

Azoknak az EA-ügyfeleknek, akik korábban a consumption.azure.com végpont mögötti Enterprise Reporting API-kat használták a használati adatok és a piactéri díjak beszerzéséhez, új és továbbfejlesztett megoldásokba kell migrálniuk. Az utasításokat az alábbiakban ismertetjük, valamint a régi API és az új megoldások közötti szerződéses különbségeket.

Az adatkészletet költségadatoknak nevezzük a használati adatok helyett.

Note

Minden Azure Enterprise Reporting API ki van állítva. A lehető leghamarabb át kell költöznie a Microsoft Cost Management API-kba .

Általánosan elérhető új megoldások

Az alábbi táblázat összefoglalja a rendelkezésre álló migrálási célhelyeket, valamint összefoglalja, hogy mit érdemes figyelembe venni, amikor kiválasztja, hogy melyik megoldás a legmegfelelőbb az Ön számára.

Solution Description Considerations Előkészítési információk
Exports Ismétlődő adatmentések a tárolóba ütemezetten - A számítási feladatokhoz leginkább méretezhető megoldás.
– Konfigurálható úgy, hogy nagyobb adathalmazokhoz használjon fájlparticionálást.
- Kiválóan alkalmas olyan költségadatkészlet létrehozására és bővítésére, amely integrálható a saját lekérdezhető adattárakkal.
-Hozzáférést igényel egy olyan tárfiókhoz, amely képes tárolni az adatokat.		 - Konfigurálás az Azure Portalon
Exportálás létrehozásának automatizálása az API-val
- API-referencia exportálása
Cost Details API Igény szerinti letöltés – Kis költségű adathalmazok esetén hasznos.
– Olyan helyzetekben hasznos, amikor az Azure Storage-ba irányuló exportálás biztonsági vagy kezelhetőségi problémák miatt nem kivitelezhető.		 - Kis költségű adathalmazok igény szerinti lekérése
- Költség részletei API

Általában az Exportálások használatát javasoljuk, ha folyamatos adatbetöltési igényekkel és/vagy nagy havi költségrészlet-adatkészletekkel rendelkezik. További információért lásd: Beviteli költségrészletek adatai. Ha további információra van szüksége a munkaterheléssel kapcsolatos döntés meghozatalához, olvassa el a Költségrészletek megoldás kiválasztása dokumentumot.

Szolgáltatás főnévhez rendelje hozzá az engedélyeket az API-k meghívásához.

Ha programozott módon szeretné meghívni az Export vagy a Cost Details API-kat, konfigurálnia kell egy szolgáltatási főelvet a megfelelő engedélyekkel. További információ: Engedélyek hozzárendelése az ACM API-khoz.

A Microsoft Consumption Usage Details API elkerülése

A Consumption Usage Details API egy másik végpont, amely jelenleg támogatja az EA-ügyfeleket. Ne migráljon erre az API-ra. Migrálás az Export vagy a Cost Details API-ba a dokumentum korábbi részében leírtak szerint. A Consumption Usage Details API a jövőben megszűnik, és a következő végpont mögött található.

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2021-10-01

Ez az API szinkron végpont, és nem fog tudni skálázni, mivel a költségek és a havi költségadatkészletek mérete is nő. Ha jelenleg a Consumption Usage Details API-t használja, javasoljuk, hogy mielőbb térjen át az Exports vagy a Cost Details API használatára. Az elavulással kapcsolatos hivatalos bejelentést egy későbbi időpontban fogjuk tenni. További információért arról, hogyan lehet felhagyni a Használati adatok API használatával, tekintse meg a Használati adatok API-tól való migrálás című részt.

A migrálás előnyei

Új megoldásaink számos előnnyel járnak az EA Reporting Usage Details API-kkal szemben. Íme egy összegzés:

  • Biztonság és stabilitás – Az új megoldásokhoz szolgáltatásnévre és/vagy felhasználói jogkivonatokra van szükség az adatok eléréséhez. Biztonságosabbak, mint az EA Reporting API-khoz való hitelesítéshez használt API-kulcsok. Az örökölt API-k kulcsai hat hónapig érvényesek, és bizalmas pénzügyi adatokat tehetnek közzé, ha kiszivárognak. Ezenkívül ha a kulcsok nem újulnak meg és integrálva lesznek a számítási feladatokba a hat hónapos lejárat előtt, az adathozzáférés visszavonásra kerül. Ez megszakítja az ügyfél munkafolyamatait.
  • Méretezhetőség – Az EA Reporting API-k nem úgy készültek, hogy skálázhatók legyenek, ahogy az Azure-használat növekszik. A használati adatok adatkészlete rendkívül nagy méretű lehet, amikor több erőforrást helyez üzembe a felhőben. Az új megoldások aszinkronok, és kiterjedt infrastruktúra-fejlesztésekkel rendelkeznek, amelyek biztosítják a sikeres letöltéseket bármilyen méretű adathalmazhoz.
  • Egyetlen adatkészlet az összes használati adathoz – Az Azure és az Azure Marketplace használati adatait egyetlen adatkészletbe egyesítették az új megoldásokban. Az egyetlen adatkészlet csökkenti az összes díj megtekintéséhez meghívni kívánt API-k számát.
  • Vásárlási amortizáció – A foglalásokat vásárló ügyfelek az új megoldások használatával amortizált nézetet láthatnak a költségeikről.
  • Sémakonzisztencia – Minden elérhető megoldás egyező mezőkkel rendelkező fájlokat biztosít. Lehetővé teszi, hogy a forgatókönyv alapján egyszerűen váltson a megoldások között.
  • Költségfelosztási integráció – Nagyvállalati Szerződés és Microsoft Ügyfélszerződés ügyfelek az új megoldással megtekinthetik az általuk konfigurált költségfelosztási szabályokkal kapcsolatos díjakat. A költségfelosztásról további információt a Költségek lefoglalása című témakörben talál.
  • Továbblépés – Az új megoldások fejlesztése folyamatban van. A megoldások a kiadásuk során minden új funkciót megkapnak.

Nagyvállalati használati API-k kivonásához

Az alábbi táblázat összefoglalja a különböző API-kat, amelyeket a mai napon használhat a költségadatok adatainak betöltéséhez. Ha az alábbi API-k egyikét használja, át kell telepítenie a korábban felvázolt új megoldások egyikére. Minden API a https://consumption.azure.com végpont mögött található.

Endpoint API-megjegyzések
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod} - API-módszer: GET
- Szinkron (nem lekérdezés)
- Adatformátum: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10 - API-módszer: GET
- Szinkron (nem lekérdezés)
- Adatformátum: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails - API-módszer: GET
- Szinkron (nem lekérdezés)
- Adatformátum: JSON
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails - API-módszer: GET
- Szinkron (nem lekérdezés)
- Adatformátum: JSON
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10 - API-módszer: GET
- Szinkron (nem lekérdezés)
- Adatformátum: JSON
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod} - API-módszer: POST
- Aszinkron (lekérdezésalapú)
- Adatformátum: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10 - API-módszer: POST
- Aszinkron (lekérdezésalapú)
- Adatformátum: CSV

Adatmező-leképezés

Az alábbi táblázat összefoglalja a jelenleg használt megoldásokban elérhető régi mezőket, valamint az új megoldásokban használni kívánt mezőt.

Régi mező Új mező Comments
accountId
accountName AccountName
accountOwnerEmail AccountOwnerId
additionalInfo AdditionalInfo
chargesBilledSeparately isAzureCreditEligible A tulajdonságok ellentétek. Ha isAzureCreditEnabled igaz, ChargesBilledSeparately akkor hamis lenne.
consumedQuantity Quantity
consumedService ConsumedService
consumedServiceId ConsumedService consumedServiceId csak számértéket ad meg.
ConsumedService adja meg a szolgáltatás nevét.
cost CostInBillingCurrency
costCenter CostCenter
date Date A régi mező formátuma yyyyy-mm-dd, míg az új mező mm/dd/ééééé formátumban van.
departmentId InvoiceSectionId
departmentName InvoiceSectionName
extendedCost CostInBillingCurrency
instanceId ResourceId
isRecurringCharge Ha lehetséges, a továbbiakban használja a Frequency és a Term fields elemeket.
hely ResourceLocationNormalized
meterCategory MeterCategory
meterId MeterId
meterName MeterName
meterRegion MeterRegion
meterSubCategory MeterSubCategory
offerId OfferId
orderNumber Nem érhető el.
partNumber PartNumber
planName PlanName
product ProductName
publisherName PublisherName
resourceGroup ResourceGroup
resourceGuid MeterId Az értékek eltérőek. resourceGuid egy GUID azonosító érték. meterId hosszú szám.
resourceLocation ResourceLocation
resourceLocationId Nem érhető el.
resourceRate EffectivePrice
serviceInfo1 ServiceInfo1
serviceInfo2 ServiceInfo2
serviceName MeterCategory
serviceTier MeterSubCategory
storeServiceIdentifier Nem érhető el.
subscriptionGuid SubscriptionId
subscriptionId SubscriptionId
subscriptionName SubscriptionName
tags Tags Az új mező nem rendelkezik kulcs-érték párok körül záró {}-lel.
unitOfMeasure UnitOfMeasure

Kapcsolódó tartalom

  • Last updated on