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 | ||
| 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 | |
| departmentName | InvoiceSectionName | |
| extendedCost | CostInBillingCurrency | |
| instanceId | ResourceId | |
| isRecurringCharge | Ha lehetséges, használja a Frequency elemet, és Term fields haladjon előre. |
|
| hely | ResourceLocationNormalized | |
| 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.