Migrera från API för användningsinformation för förbrukning

I den här artikeln beskrivs migrering bort från API:et för användningsinformation för förbrukning, som planeras för utfasning. Det exakta datumet för utfasningen bestäms fortfarande. Vi rekommenderar att du inte skapar dina rapportpipelines med hjälp av det här API:et och migrerar bort från det så snart som möjligt.

FÖRETAGSAVTAL-rapporterings-API:er (EA), som använder en API-nyckel för autentisering och som nås via consumption.azure.com URI-slutpunkt, dras tillbaka. EA-kunder som använder dessa API:er bör migrera till Kostnadsinformations-API:et för Cost Management. Dessa äldre EA-rapporterings-API:er är endast tillgängliga för kunder med en företagsavtal.

Om du använder API:et Förbrukningsinformation rekommenderar vi, men kräver inte att du migrerar till Cost Management Cost Details API.

API:er för förbrukning och Cost Management är tillgängliga för både EA Microsoft-kundavtal-kunder (MCA). Därför påverkas inte Azure Government-kunder som är kvar under ett EA negativt.

När du migrerar från EA till MCA rekommenderar vi att du går från API:et för EA-rapporteringsanvändningsinformation till Cost Management Cost Details API och använder exporter.

Migreringsmål

Läs artikeln Välj en kostnadsinformationslösning innan du väljer vilken lösning som passar din arbetsbelastning. I allmänhet rekommenderar vi Exporter om du har pågående datainmatningsbehov och eller en stor månatlig datauppsättning med användningsinformation. Mer information finns i Mata in användningsinformationsdata.

Om du har en mindre datauppsättning med användningsinformation eller ett scenario som inte uppfylls av exporter bör du överväga att använda rapporten Kostnadsinformation i stället. Mer information finns i Hämta små kostnadsdatamängder på begäran.

Migreringsfördelar

Nya lösningar ger många fördelar jämfört med API:et för användningsinformation för förbrukning. Här är en sammanfattning:

• Enkel datauppsättning för all användningsinformation – Användningsinformation för Azure och Azure Marketplace sammanfogades till en datauppsättning. Det minskar antalet API:er som du behöver anropa för att få se alla dina avgifter.
• Skalbarhet – Marketplaces API är inaktuellt eftersom det främjar ett anropsmönster som inte kan skalas när din Azure-användning ökar. Datauppsättningen med användningsinformation kan bli stor när du distribuerar fler resurser till molnet. Marketplaces API är ett sidnumrerat synkront API så det är inte optimerat för att effektivt överföra stora mängder data via ett nätverk med hög effektivitet och tillförlitlighet. Exporter och API:et för kostnadsinformation är asynkrona. De ger dig en CSV-fil som kan laddas ned direkt via nätverket.
• API-förbättringar – Exporter och API för kostnadsinformation är de lösningar som Azure Support framöver. Alla nya funktioner integreras i dem.
• Schemakonsekvens – Kostnadsinformationsrapporten och Exporter ger filer med matchande fält os som du kan flytta från en lösning till en annan, baserat på ditt scenario.
• Kostnadsallokeringsintegrering – företagsavtal och Microsoft-kundavtal kunder som använder exporter eller API:et för kostnadsinformation kan visa avgifter i förhållande till de kostnadsallokeringsregler som de har konfigurerat. Mer information om kostnadsallokering finns i Allokera kostnader.

Fältskillnader

I följande tabell sammanfattas fältskillnaderna mellan API:et Förbrukningsinformation och API:et export/kostnadsinformation. Exporter och API för kostnadsinformation tillhandahåller en CSV-filnedladdning i stället för det sidnumrerade JSON-svaret som tillhandahålls av förbruknings-API:et.

företagsavtal fältmappning

företagsavtal kunder som använder API:et Förbrukningsinformation har användningsinformationsposter av typen legacy. Alla företagsavtal kunder har poster av den här typen på grund av det underliggande faktureringssystemet som används för dem. Här är ett exempel på en äldre användningsinformationspost:

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "legacy",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

Ett fullständigt exempel på äldre användningsinformationspost visas i Användningsinformation – Lista – REST API (Azure Consumption)

Följande tabell innehåller en mappning mellan de gamla och nya fälten. Nya egenskaper är tillgängliga i CSV-filerna som skapas av exporter och API:et kostnadsinformation. Mer information om fälten finns i Förstå fält för användningsinformation.

Namn på fetstil är oförändrade.

Microsoft-kundavtal fältmappning

Microsoft-kundavtal kunder som använder API:et Förbrukningsinformation har användningsinformationsposter av typen modern. Alla Microsoft-kundavtal kunder har sådana poster på grund av det underliggande faktureringssystemet som används för dem. Här är ett exempel på en mca-användningsinformationspost:

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "modern",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

Ett fullständigt exempel på äldre användningsinformationspost visas i Användningsinformation – Lista – REST API (Azure Consumption)

En mappning mellan de gamla och nya fälten visas i följande tabell. Nya egenskaper är tillgängliga i CSV-filerna som skapas av exporter och API:et kostnadsinformation. Fält som behöver en mappning på grund av skillnader mellan lösningarna visas i fet text.

Mer information finns i Förstå fält för användningsinformation.

Relaterat innehåll

• Läs mer om Cost Management + Faktureringsautomation i Översikt över Cost Management Automation.