Migrera från API:er för EA-användningsinformation

EA customers who were previously using the Enterprise Reporting APIs behind the consumption.azure.com endpoint to obtain usage details and marketplace charges need to migrate to new and improved solutions. Anvisningarna beskrivs nedan tillsammans med kontraktsskillnader mellan det gamla API:et och de nya lösningarna.

The dataset is referred to as cost details instead of usage details.

Nya lösningar allmänt tillgängliga

Följande tabell innehåller en sammanfattning av de migreringsmål som är tillgängliga tillsammans med en sammanfattning av vad du bör tänka på när du väljer vilken lösning som är bäst för dig.

Generally we recommend using Exports if you have ongoing data ingestion needs and/or a large monthly cost details dataset. För mer information, se Kostnadsdata för intag. Om du behöver ytterligare information som hjälper dig att fatta ett beslut för din arbetsbelastning kan du läsa Välj en lösning för kostnadsinformation.

Tilldela behörigheter till ett SPN för att anropa API:erna

Om du vill anropa API:er för export eller kostnadsinformation programmatiskt måste du konfigurera ett tjänsthuvudnamn med rätt behörighet. Mer information finns i Tilldela behörigheter till ACM-API:er.

Undvik API:et för Användningsinformation för Microsoft-förbrukning

Consumption Usage Details API är en annan endpoint som för närvarande stöder EA-kunder. Migrera inte till det här API:et. Migrera till antingen Exporter eller API:et för kostnadsinformation, enligt beskrivningen tidigare i det här dokumentet. API:et för Förbrukningsanvändningsdetaljer kommer att avvecklas framöver och finns bakom följande slutpunkt.

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

Det här API:et är en synkron slutpunkt och kan inte skalas när både dina utgifter och storleken på kostnadsdatauppsättningen för månad över månad ökar. Om du för närvarande använder API:et för användningsinformation för förbrukning rekommenderar vi att du migrerar från det till antingen exporter eller API:et för kostnadsinformation så snart som möjligt. Ett formellt utfasningsmeddelande kommer att göras vid ett framtida datum. Mer information om hur du migrerar bort från förbrukningsanvändningsdetaljer finns i Migrera från API för förbrukningsanvändningsdetaljer.

Migration benefits

Våra nya lösningar ger många fördelar jämfört med API:erna för EA-rapporteringsanvändningsinformation. Här är en sammanfattning:

• Säkerhet och stabilitet – Nya lösningar kräver tjänstens huvudnamn och/eller användartoken för att få åtkomst till data. De är säkrare än de API-nycklar som används för autentisering till EA Reporting-API:erna. Nycklar i dessa äldre API:er är giltiga i sex månader och kan exponera känsliga finansiella data om de läcker ut. Om nycklar inte förnyas och integreras i arbetsbelastningar innan de upphör att gälla i sex månader återkallas dessutom dataåtkomsten. Detta stör kundens arbetsbelastning.
• Scalability - The EA Reporting APIs aren't built to scale well as your Azure usage increases. Datauppsättningen med användningsinformation kan bli mycket stor när du distribuerar fler resurser till molnet. De nya lösningarna är asynkrona och har omfattande infrastrukturförbättringar bakom sig för att säkerställa lyckade nedladdningar för alla storleksdatauppsättningar.
• Enkel datauppsättning för all användningsinformation – Användningsinformation för Azure och Azure Marketplace sammanfogades till en datauppsättning i de nya lösningarna. Den enskilda datamängden minskar antalet API:er som du behöver anropa för att se alla dina avgifter.
• Purchase amortization - Customers who purchase Reservations can see an Amortized view of their costs using the new solutions.
• Schema consistency - Each solution that is available provides files with matching fields. Det gör att du enkelt kan flytta mellan lösningar baserat på ditt scenario.
• Kostnadsallokeringsintegrering – företagsavtal och Microsoft-kundavtal kunder kan använda den nya lösningen för att visa avgifter i förhållande till de kostnadsallokeringsregler som de har konfigurerat. For more information about cost allocation, see Allocate costs.
• Gå vidare förbättringar – De nya lösningarna utvecklas aktivt framöver. Lösningarna får alla nya funktioner när de släpps.

API:er för företagsanvändning som ska migreras bort

I följande tabell sammanfattas de olika API:er som du kanske använder i dag för att mata in kostnadsinformationsdata. Om du använder något av följande API:er måste du migrera till någon av de nya lösningar som beskrevs tidigare. Alla API:er finns bakom https://consumption.azure.com slutpunkten.

Datafältmappning

Följande tabell innehåller en sammanfattning av de gamla fälten som är tillgängliga i de lösningar som du för närvarande använder tillsammans med fältet som ska användas i de nya lösningarna.

Related content

• Läs översiktsartikeln Migrera från EA-rapportering till Azure Resource Manager-API:er.