Migrera från API:er för EA-användningsinformation
EA-kunder som tidigare använde API:erna för Enterprise Reporting bakom consumption.azure.com slutpunkten för att få användningsinformation och marketplace-avgifter måste migreras till nya och förbättrade lösningar. Anvisningarna beskrivs nedan tillsammans med kontraktsskillnader mellan det gamla API:et och de nya lösningarna.
Datamängden kallas kostnadsinformation i stället för användningsinformation.
Kommentar
Alla Azure Enterprise Reporting-API:er har dragits tillbaka. Du bör migrera till Microsoft Cost Management-API:er så snart som möjligt.
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.
| Lösning | beskrivning | Överväganden | Registreringsinformation |
|---|---|---|---|
| Exporter | Återkommande datadumpar till lagring enligt ett schema | – Den mest skalbara lösningen för dina arbetsbelastningar. – Kan konfigureras för att använda filpartitionering för större datauppsättningar. – Perfekt för att etablera och utveckla en kostnadsdatauppsättning som kan integreras med dina egna frågebara datalager. – Kräver åtkomst till ett lagringskonto som kan lagra data. |
- Konfigurera i Azure Portal Automatisera skapandet av export med API:et - Exportera API-referens |
| API för kostnadsinformation | Nedladdning på begäran | – Användbart för små kostnadsdatauppsättningar. – Användbart för scenarier när exporter till Azure Storage inte är möjliga på grund av säkerhets- eller hanterbarhetsproblem. |
- Hämta små kostnadsdatauppsättningar på begäran - API för kostnadsinformation |
Vanligtvis rekommenderar vi att du använder Exporter om du har pågående datainmatningsbehov och/eller en datauppsättning med stor månatlig kostnadsinformation. Mer information finns i Mata in information om kostnader. 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
API:et Förbrukningsinformation är en annan slutpunkt 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örbrukningsinformation kommer att bli inaktuellt i framtiden 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 av 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örbrukningsinformation finns i Migrera från API för användningsinformation för förbrukning.
Migreringsfördelar
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 bryter kundens arbetsbelastningar.
- Skalbarhet – API:erna för EA-rapportering är inte byggda för att skalas lika bra som din Azure-användning ökar. 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.
- Amortering av köp – Kunder som köper reservationer kan se en amorterad vy över sina kostnader med hjälp av de nya lösningarna.
- Schemakonsekvens – Varje lösning som är tillgänglig innehåller filer med matchande fält. 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. Mer information om kostnadsallokering finns i Allokera kostnader.
- 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
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.
| Slutpunkt | API-kommentarer |
|---|---|
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod} |
– API-metod: GET – Synkron (ej avsökning) – Dataformat: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10 |
– API-metod: GET – Synkron (ej avsökning) – Dataformat: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails |
– API-metod: GET – Synkron (ej avsökning) – Dataformat: JSON |
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails |
– API-metod: GET – Synkron (ej avsökning) – Dataformat: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10 |
– API-metod: GET – Synkron (ej avsökning) – Dataformat: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod} |
- API-metod: POST – Asynkron (avsökningsbaserad) – Dataformat: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10 |
- API-metod: POST – Asynkron (avsökningsbaserad) – Dataformat: CSV |
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.
| Gammalt fält | Nytt fält | Kommentarer |
|---|---|---|
| accountId | Inte tillgängligt – Använd AccountName för att hämta kontoinformationen. | |
| accountName | AccountName | |
| accountOwnerEmail | AccountOwnerId | |
| additionalInfo | AdditionalInfo | |
| chargesBilledSeparately | isAzureCreditEligible | Egenskaperna är motsatser. Om isAzureCreditEnabled är sant, ChargesBilledSeparately skulle vara falskt. |
| consumedQuantity | Kvantitet | |
| consumedService | ConsumedService | |
| consumedServiceId | ConsumedService | consumedServiceId innehåller bara ett talvärde.ConsumedService tillhandahåller namnet på tjänsten. |
| cost | CostInBillingCurrency | |
| costCenter | CostCenter | |
| datum | Datum | Formatet i det gamla fältet var åååå-mm-dd, medan det nya fältet är i formatet mm/dd/åååå. |
| departmentId | InvoiceSectionId | Fältet är för närvarande tomt. Använd DepartmentName för att hämta avdelningsinformationen. |
| departmentName | InvoiceSectionName | |
| extendedCost | CostInBillingCurrency | |
| instanceId | ResourceId | |
| isRecurringCharge | Använd i tillämpliga fall Frequency och Term fields framåt. |
|
| plats | ResourceLocationNormalized | ResourceLocationNormalized finns i rapporten Kostnadsinformation, men ännu inte i exporten. |
| meterCategory | MeterCategory | |
| meterId | MeterId | |
| meterName | MeterName | |
| meterRegion | MeterRegion | |
| meterSubCategory | MeterSubCategory | |
| offerId | OfferId | |
| orderNumber | Ej tillgänglig. | |
| partNumber | ArtNr | |
| planName | PlanName | |
| produkt | ProductName | |
| publisherName | PublisherName | |
| resourceGroup | ResourceGroup | |
| resourceGuid | MeterId | Värdena varierar. resourceGuid är ett GUID-värde. meterId är ett långt tal. |
| resourceLocation | ResourceLocation | |
| resourceLocationId | Ej tillgänglig. | |
| resourceRate | EffectivePrice | |
| serviceInfo1 | ServiceInfo1 | |
| serviceInfo2 | ServiceInfo2 | |
| Tjänstnamn | MeterCategory | |
| serviceTier | MeterSubCategory | |
| storeServiceIdentifier | Ej tillgänglig. | |
| subscriptionGuid | SubscriptionId | |
| subscriptionId | SubscriptionId | |
| subscriptionName | SubscriptionName | |
| taggar | Taggar | Det nya fältet innehåller {} inte nyckel/värde-paren. |
| unitOfMeasure | UnitOfMeasure |