Migreren van API's voor EA-gebruiksgegevens
EA-klanten die eerder de Enterprise Reporting-API's achter het consumption.azure.com-eindpunt gebruikten om gebruiksgegevens en marketplace-kosten te verkrijgen, moeten worden gemigreerd naar nieuwe en verbeterde oplossingen. Instructies worden hieronder beschreven, samen met contractverschillen tussen de oude API en de nieuwe oplossingen.
De gegevensset wordt kostendetails genoemd in plaats van gebruiksgegevens.
Notitie
Alle Azure Enterprise Reporting-API's worden buiten gebruik gesteld. U moet zo snel mogelijk migreren naar Microsoft Cost Management-API's .
Nieuwe oplossingen algemeen beschikbaar
De volgende tabel bevat een overzicht van de migratiebestemmingen die beschikbaar zijn, samen met een overzicht van wat u moet overwegen bij het kiezen van welke oplossing het beste voor u is.
| Oplossing | Beschrijving | Overwegingen | Onboarding-informatie |
|---|---|---|---|
| Exports | Terugkerende gegevensdumps naar opslag volgens een schema | - De meest schaalbare oplossing voor uw workloads. - Kan worden geconfigureerd voor het gebruik van bestandspartitionering voor grotere gegevenssets. - Ideaal voor het opzetten en uitbreiden van een kostengegevensset die kan worden geïntegreerd met uw eigen doorzoekbare gegevensarchieven. -Vereist toegang tot een opslagaccount dat de gegevens kan bevatten. |
- Configureren in Azure Portal Het maken van exporteren automatiseren met de API - Api-verwijzing exporteren |
| API voor kostendetails | Downloaden op aanvraag | - Handig voor gegevenssets met kleine kosten. - Handig voor scenario's waarin exports naar Azure-opslag niet haalbaar zijn vanwege beveiligings- of beheerbaarheidsproblemen. |
- Gegevenssets met kleine kosten op aanvraag ophalen - API voor kostendetails |
Over het algemeen raden we u aan exports te gebruiken als u doorlopende gegevensopnamebehoeften en/of een grote gegevensset met maandelijkse kostengegevens hebt. Zie Gegevens over kosten opnemen voor meer informatie. Als u aanvullende informatie nodig hebt om u te helpen bij het nemen van een beslissing voor uw workload, raadpleegt u Een oplossing voor kostendetails kiezen.
Machtigingen toewijzen aan een SPN om de API's aan te roepen
Als u de API's exports of Cost Details programmatisch wilt aanroepen, moet u een service-principal configureren met de juiste machtiging. Zie Machtigingen toewijzen aan ACM-API's voor meer informatie.
De API voor gebruiksgegevens van Microsoft vermijden
De API verbruiksdetails is een ander eindpunt dat momenteel EA-klanten ondersteunt. Migreer niet naar deze API. Migreren naar exports of de API voor kostendetails, zoals eerder in dit document is beschreven. De API voor verbruiksgebruiksgegevens wordt in de toekomst afgeschaft en bevindt zich achter het volgende eindpunt.
GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2021-10-01
Deze API is een synchroon eindpunt en kan niet worden geschaald omdat zowel uw uitgaven als de grootte van uw maand in de kostengegevensset van de maand toeneemt. Als u momenteel de API verbruiksdetails gebruikt, raden we u aan om deze zo snel mogelijk te migreren naar exports van de API voor kostendetails. Er wordt een formele afschaffingsaankondiging gedaan op een toekomstige datum. Zie Migrate from Consumption Usage Details API(Migrate from Consumption Usage Details API) voor meer informatie over het migreren van verbruiksgebruiksgegevens.
Migratievoordelen
Onze nieuwe oplossingen bieden veel voordelen ten opzichte van de API's voor EA Reporting Usage Details. Hier volgt een samenvatting:
- Beveiliging en stabiliteit : voor nieuwe oplossingen zijn service-principal- en/of gebruikerstokens vereist om toegang te krijgen tot gegevens. Ze zijn veiliger dan de API-sleutels die worden gebruikt voor verificatie bij de EA Reporting-API's. Sleutels in deze verouderde API's zijn zes maanden geldig en kunnen gevoelige financiële gegevens beschikbaar maken als ze worden gelekt. Als sleutels bovendien niet worden vernieuwd en geïntegreerd in workloads voordat ze zes maanden verlopen, wordt de toegang tot gegevens ingetrokken. Hierdoor worden de workloads van klanten verbroken.
- Schaalbaarheid: de EA Reporting-API's zijn niet gebouwd om te schalen en uw Azure-gebruik neemt toe. De gegevensset met gebruiksgegevens kan zeer groot worden naarmate u meer resources in de cloud implementeert. De nieuwe oplossingen zijn asynchroon en hebben uitgebreide verbeteringen in de infrastructuur om ervoor te zorgen dat alle groottegegevenssets succesvol worden gedownload.
- Eén gegevensset voor alle gebruiksgegevens : Azure en Azure Marketplace-gebruiksgegevens zijn samengevoegd in één gegevensset in de nieuwe oplossingen. De enkele gegevensset vermindert het aantal API's dat u moet aanroepen om al uw kosten te zien.
- Aankoopafschrijving : klanten die reserveringen kopen, kunnen een afgeschreven weergave van hun kosten bekijken met behulp van de nieuwe oplossingen.
- Schemaconsistentie : elke oplossing die beschikbaar is, biedt bestanden met overeenkomende velden. Hiermee kunt u eenvoudig schakelen tussen oplossingen op basis van uw scenario.
- Integratie van kostentoewijzing: Enterprise Overeenkomst en Microsoft-klantovereenkomst klanten kunnen de nieuwe oplossing gebruiken om kosten te bekijken ten opzichte van de regels voor kostentoewijzing die ze hebben geconfigureerd. Zie Kosten toewijzen voor meer informatie over kostentoewijzing.
- Vooruitgaand verbeteringen - De nieuwe oplossingen worden actief ontwikkeld. De oplossingen ontvangen alle nieuwe functies wanneer ze worden uitgebracht.
Api's voor enterprisegebruik die moeten worden gemigreerd
De volgende tabel bevat een overzicht van de verschillende API's die u mogelijk vandaag gebruikt om gegevens over kostengegevens op te nemen. Als u een van de volgende API's gebruikt, moet u migreren naar een van de nieuwe oplossingen die eerder zijn beschreven. Alle API's bevinden zich achter het https://consumption.azure.com eindpunt.
| Eindpunt | API-opmerkingen |
|---|---|
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod} |
- API-methode: GET - Synchroon (niet-polling) - Gegevensindeling: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10 |
- API-methode: GET - Synchroon (niet-polling) - Gegevensindeling: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails |
- API-methode: GET - Synchroon (niet-polling) - Gegevensindeling: JSON |
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails |
- API-methode: GET - Synchroon (niet-polling) - Gegevensindeling: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10 |
- API-methode: GET - Synchroon (niet-polling) - Gegevensindeling: JSON |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod} |
- API-methode: POST - Asynchroon (polling gebaseerd) - Gegevensindeling: CSV |
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10 |
- API-methode: POST - Asynchroon (polling gebaseerd) - Gegevensindeling: CSV |
Toewijzing van gegevensvelden
De volgende tabel bevat een overzicht van de oude velden die beschikbaar zijn in de oplossingen die u momenteel gebruikt, samen met het veld dat u in de nieuwe oplossingen kunt gebruiken.
| Oud veld | Nieuw veld | Opmerkingen |
|---|---|---|
| accountId | ||
| accountName | AccountName | |
| accountOwnerEmail | AccountOwnerId | |
| additionalInfo | AdditionalInfo | |
| chargesBilledSeparately | isAzureCreditEligible | De eigenschappen zijn tegengestelden. Als isAzureCreditEnabled waar is, ChargesBilledSeparately zou dit onwaar zijn. |
| consumedQuantity | Hoeveelheid | |
| consumedService | ConsumedService | |
| consumedServiceId | ConsumedService | consumedServiceId geeft alleen een getalwaarde op.ConsumedService geeft de naam van de service op. |
| kosten | CostInBillingCurrency | |
| costCenter | CostCenter | |
| datum | Datum | De notatie in het oude veld was jjjj-mm-dd, terwijl het nieuwe veld de notatie mm/dd/jjjj heeft. |
| departmentId | InvoiceSectionId | |
| departmentName | InvoiceSectionName | |
| extendedCost | CostInBillingCurrency | |
| instanceId | ResourceId | |
| isRecurringCharge | Gebruik, indien van toepassing, de Frequency en Term fields volgende stap. |
|
| locatie | ResourceLocationNormalized | |
| meterCategory | MeterCategory | |
| meterId | MeterId | |
| meterName | MeterName | |
| meterRegion | MeterRegion | |
| meterSubCategory | MeterSubCategory | |
| offerId | OfferId | |
| orderNumber | Niet beschikbaar. | |
| partNumber | PartNumber | |
| planName | PlanName | |
| product | ProductName | |
| publisherName | PublisherName | |
| resourceGroup | ResourceGroup | |
| resourceGuid | MeterId | Waarden variëren. resourceGuid is een GUID-waarde. meterId is een lang getal. |
| resourceLocation | ResourceLocation | |
| resourceLocationId | Niet beschikbaar. | |
| resourceRate | EffectivePrice | |
| serviceInfo1 | ServiceInfo1 | |
| serviceInfo2 | ServiceInfo2 | |
| serviceName | MeterCategory | |
| serviceTier | MeterSubCategory | |
| storeServiceIdentifier | Niet beschikbaar. | |
| subscriptionGuid | SubscriptionId | |
| subscriptionId | SubscriptionId | |
| subscriptionName | SubscriptionName | |
| tags | Tags | Het nieuwe veld bevat niet het omsluiten {} rond de sleutel-waardeparen. |
| unitOfMeasure | UnitOfMeasure |
Gerelateerde inhoud
- Lees het overzichtsartikel Over migreren van EA Reporting naar Azure Resource Manager-API's.