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.

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 .

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

Megoldás	Leírás	Megfontolandó szempontok	Előkészítési információk
Export	Ismétlődő adatleképezések a tárolóba ütemezés szerint	- 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 - Cost Details 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ó: Ingest cost details data. Ha további információra van szüksége a számítási feladathoz való döntéshez, olvassa el a Költség részleteinek kiválasztása megoldást.

Engedélyek hozzárendelése egyszerű szolgáltatásnévhez 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 egyszerű szolgáltatást 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 mihamarabb migrálja azt a Cost Details API bármelyik exportálására. Az elavulással kapcsolatos hivatalos bejelentést egy későbbi időpontban fogjuk tenni. A használati adatoktól való migrálásról további információt a Használati adatok API-ból való migrálással kapcsolatban talál.

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 számítási feladatait.
• 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 a migráláshoz

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

Végpont	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ő	Megjegyzések
accountId		Nem érhető el – A fiókadatok lekéréséhez használja az AccountName parancsot.
accountName	AccountName
accountOwnerEmail	AccountOwnerId
additionalInfo	További információk (Info)
chargesBilledSeparately	isAzureCreditEligible	A tulajdonságok ellentétek. Ha isAzureCreditEnabled igaz, ChargesBilledSeparately akkor hamis lenne.
consumedQuantity	Mennyiség
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
dátum:	Dátum	A régi mező formátuma yyyyy-mm-dd, míg az új mező mm/dd/ééééé formátumban van.
departmentId	InvoiceSectionId	A mező jelenleg üres. A részleg adatainak lekérésére szolgál DepartmentName .
departmentName	InvoiceSectionName
extendedCost	CostInBillingCurrency
instanceId	ResourceId
isRecurringCharge		Ha lehetséges, használja a Frequency elemet, és Term fields haladjon előre.
hely	ResourceLocationNormalized	ResourceLocationNormalized szerepel a Cost Details jelentésben, de még nem szerepel az exportálásokban.
meterCategory	MeterCategory
meterId	MeterId
meterName	MeterName
meterRegion	MeterRegion
meterSubCategory	MeterSubCategory
offerId	OfferId
orderNumber		Nem érhető el.
partNumber	Cikkszám
planName	PlanName
product	ProductName
publisherName	Közzétevő neve
resourceGroup	ResourceGroup
resourceGuid	MeterId	Az értékek eltérőek. resourceGuid GUID-é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
címkét	Címkék	Az új mező nem rendelkezik a kulcs-érték párok {} körül.
unitOfMeasure	UnitOfMeasure

Kapcsolódó tartalom

• Olvassa el az Ea Reportingból az Azure Resource Manager API-kba történő migrálás áttekintési cikket.