Migreren vanuit de API voor gebruiksgegevens van verbruik
In dit artikel wordt de migratie besproken van de API voor verbruiksgebruiksgegevens, die is gepland voor afschaffing. De exacte datum van afschaffing wordt nog steeds bepaald. U wordt aangeraden uw rapportagepijplijnen niet te bouwen met behulp van deze API en deze zo snel mogelijk weg te migreren.
De Enterprise Overeenkomst (EA) rapportage-API's, die gebruikmaken van een API-sleutel voor verificatie en toegankelijk zijn via het consumption.azure.com URI-eindpunt, worden buiten gebruik gesteld. EA-klanten die deze API's gebruiken, moeten worden gemigreerd naar de Cost Management Cost Details-API . Deze oudere EA-rapportage-API's zijn alleen beschikbaar voor klanten met een Enterprise Overeenkomst.
Als u de API verbruiksdetails gebruikt, wordt u aangeraden, maar hoeft u niet te migreren naar de Cost Management Cost Details-API.
Verbruiks- en Cost Management-API's zijn beschikbaar voor zowel EA Microsoft-klantovereenkomst (MCA)-klanten. Azure Government-klanten die onder een EA blijven, worden dus niet negatief beïnvloed.
Wanneer u migreert van EA naar MCA, wordt u aangeraden over te stappen van de API voor EA-rapportagegebruiksgegevens naar de COST Management Cost Details-API en Exports te gebruiken.
Migratiebestemmingen
Lees het artikel Een oplossing voor kostendetails kiezen voordat u kiest welke oplossing geschikt is voor uw workload. Over het algemeen raden we exports aan als u doorlopende gegevensopnamebehoeften hebt en of een grote gegevensset met maandelijkse gebruiksgegevens. Zie Gebruiksgegevens opnemen voor meer informatie.
Als u een kleinere gegevensset met gebruiksgegevens of een scenario hebt dat niet wordt bereikt door Exports, kunt u in plaats daarvan het rapport Kostendetails gebruiken. Zie Gegevenssets met kleine kosten op aanvraag ophalen voor meer informatie.
Notitie
Het rapport Kostendetails is alleen beschikbaar voor klanten met een Enterprise Overeenkomst of Microsoft-klantovereenkomst. Als u een MSDN-, betalen per gebruik- of Visual Studio-abonnement hebt, kunt u migreren naar Exports of doorgaan met het gebruik van de API verbruiksdetails.
Migratievoordelen
Nieuwe oplossingen bieden veel voordelen ten opzichte van de API verbruiksdetails. Hier volgt een samenvatting:
- Eén gegevensset voor alle gebruiksgegevens : Azure en Azure Marketplace-gebruiksgegevens zijn samengevoegd in één gegevensset. Het vermindert het aantal API's dat u moet aanroepen om al uw kosten te zien.
- Schaalbaarheid: de Marketplaces-API is afgeschaft omdat het een aanroeppatroon bevordert dat niet kan worden geschaald naarmate uw Azure-gebruik toeneemt. De gegevensset met gebruiksgegevens kan groot worden naarmate u meer resources in de cloud implementeert. De Marketplaces-API is een gepagineerde synchrone API, zodat deze niet is geoptimaliseerd om grote hoeveelheden gegevens effectief over te dragen via een netwerk met hoge efficiëntie en betrouwbaarheid. Exports en de API voor kostendetails zijn asynchroon. Ze bieden u een CSV-bestand dat rechtstreeks via het netwerk kan worden gedownload.
- API-verbeteringen: exports en de API voor kostendetails zijn de oplossingen die ondersteuning voor Azure in de toekomst. Alle nieuwe functies worden erin geïntegreerd.
- Schemaconsistentie : het rapport Kostendetails en Exports bieden bestanden met overeenkomende velden die u kunt verplaatsen van de ene oplossing naar de andere, op basis van uw scenario.
- Integratie van kostentoewijzing: Enterprise Overeenkomst en Microsoft-klantovereenkomst klanten die exports of de API kostendetails gebruiken, kunnen kosten bekijken in relatie tot de regels voor kostentoewijzing die ze hebben geconfigureerd. Zie Kosten toewijzen voor meer informatie over kostentoewijzing.
Veldverschillen
De volgende tabel bevat een overzicht van de veldverschillen tussen de API Verbruiksgebruiksgegevens en de EXPORT-/Cost Details-API. Exports en de API voor kostendetails bieden een CSV-bestand dat wordt gedownload in plaats van het gepagineerde JSON-antwoord dat wordt geleverd door de Verbruiks-API.
Enterprise Overeenkomst veldtoewijzing
Enterprise Overeenkomst klanten die de API verbruiksdetails gebruiken, hebben gegevens over gebruiksgegevens van het typelegacy. Alle Enterprise Overeenkomst klanten hebben dit soort records vanwege het onderliggende factureringssysteem dat voor hen wordt gebruikt. Hier volgt een voorbeeld van een record met verouderde gebruiksgegevens:
{
"value": [
{
"id": "{id}",
"name": "{name}",
"type": "Microsoft.Consumption/usageDetails",
"kind": "legacy",
"tags": {
"env": "newcrp",
"dev": "tools"
},
"properties": {
…...
}
}
Een volledig voorbeeld van een verouderde record voor gebruiksgegevens wordt weergegeven in Gebruiksgegevens - Lijst - REST API (Azure Consumption)
De volgende tabel bevat een toewijzing tussen de oude en nieuwe velden. Nieuwe eigenschappen zijn beschikbaar in de CSV-bestanden die worden geproduceerd door Exports en de API voor Kostendetails. Zie Informatie over de velden voor gebruiksgegevens voor meer informatie over de velden.
Vetgedrukte eigenschapsnamen zijn ongewijzigd.
| Oude eigenschap | Nieuwe eigenschap |
|---|---|
| accountName | AccountName |
| AccountOwnerId | AccountOwnerId |
| additionalInfo | AdditionalInfo |
| AvailabilityZone | AvailabilityZone |
| billingAccountId | BillingAccountId |
| billingAccountName | BillingAccountName |
| billingCurrency | BillingCurrencyCode |
| billingPeriodEndDate | BillingPeriodEndDate |
| billingPeriodStartDate | BillingPeriodStartDate |
| billingProfileId | BillingProfileId |
| billingProfileName | BillingProfileName |
| chargeType | ChargeType |
| consumedService | ConsumedService |
| kosten | CostInBillingCurrency |
| costCenter | CostCenter |
| datum | Datum |
| effectivePrice | EffectivePrice |
| frequency | Frequentie |
| invoiceSection | InvoiceSectionName |
| InvoiceSectionId | InvoiceSectionId |
| isAzureCreditEligible | IsAzureCreditEligible |
| meterCategory | MeterCategory |
| meterId | MeterId |
| meterName | MeterName |
| MeterRegio | MeterRegion |
| meterSubCategory | MeterSubCategory |
| offerId | OfferId |
| partNumber | PartNumber |
| PayGPrice | PayGPrice |
| PlanName | PlanName |
| PricingModel | PricingModel |
| product | ProductName |
| ProductOrderId | ProductOrderId |
| ProductOrderName | ProductOrderName |
| PublisherName | PublisherName |
| PublisherType | PublisherType |
| quantity | Hoeveelheid |
| ReservationId | ReservationId |
| ReservationName | ReservationName |
| resourceGroup | ResourceGroup |
| resourceId | ResourceId |
| resourceLocation | ResourceLocation |
| resourceName | ResourceName |
| serviceFamily | ServiceFamily |
| ServiceInfo1 | ServiceInfo1 |
| ServiceInfo2 | ServiceInfo2 |
| subscriptionId | SubscriptionId |
| subscriptionName | SubscriptionName |
| Tags | Tags |
| Term | Term |
| unitOfMeasure | UnitOfMeasure |
| unitPrice | UnitPrice |
| CostAllocationRuleName | CostAllocationRuleName |
Microsoft-klantovereenkomst veldtoewijzing
Microsoft-klantovereenkomst klanten die gebruikmaken van de API verbruiksgebruiksgegevens, hebben gebruiksgegevensrecords van het typemodern. Alle Microsoft-klantovereenkomst klanten hebben dit soort records vanwege het onderliggende factureringssysteem dat voor hen wordt gebruikt. Hier volgt een voorbeeld van een mca-gebruiksgegevensrecord:
{
"value": [
{
"id": "{id}",
"name": "{name}",
"type": "Microsoft.Consumption/usageDetails",
"kind": "modern",
"tags": {
"env": "newcrp",
"dev": "tools"
},
"properties": {
…...
}
}
Een volledig voorbeeld van een verouderde record voor gebruiksgegevens wordt weergegeven in Gebruiksgegevens - Lijst - REST API (Azure Consumption)
In de volgende tabel ziet u een toewijzing tussen de oude en nieuwe velden. Nieuwe eigenschappen zijn beschikbaar in de CSV-bestanden die worden geproduceerd door Exports en de API voor Kostendetails. Velden die een toewijzing nodig hebben vanwege verschillen in de oplossingen, worden vetgedrukt weergegeven.
Zie Informatie over de velden voor gebruiksgegevens voor meer informatie.
| Oude eigenschap | Nieuwe eigenschap |
|---|---|
| InvoiceId | InvoiceId |
| previousInvoiceId | previousInvoiceId |
| billingAccountId | billingAccountId |
| billingAccountName | billingAccountName |
| billingProfileId | billingProfileId |
| billingProfileName | billingProfileName |
| invoiceSectionId | invoiceSectionId |
| invoiceSectionName | invoiceSectionName |
| partnerTenantId | partnerTenantId |
| partnernaam | partnernaam |
| resellerName | resellerName |
| resellerMpnId | resellerMpnId |
| customerTenantId | customerTenantId |
| customerName | customerName |
| costCenter | costCenter |
| billingPeriodEndDate | billingPeriodEndDate |
| billingPeriodStartDate | billingPeriodStartDate |
| servicePeriodEndDate | servicePeriodEndDate |
| servicePeriodStartDate | servicePeriodStartDate |
| datum | datum |
| serviceFamily | serviceFamily |
| productOrderId | productOrderId |
| productOrderName | productOrderName |
| consumedService | consumedService |
| meterId | meterId |
| meterName | meterName |
| meterCategory | meterCategory |
| meterSubCategory | meterSubCategory |
| meterRegion | meterRegion |
| productIdentifier | Productid |
| product | ProductName |
| subscriptionGuid | SubscriptionId |
| subscriptionName | subscriptionName |
| publisherType | publisherType |
| publisherId | publisherId |
| publisherName | publisherName |
| resourceGroup | resourceGroupName |
| instanceName | ResourceId |
| resourceLocationNormalized | location |
| resourceLocation | location |
| effectivePrice | effectivePrice |
| quantity | quantity |
| unitOfMeasure | unitOfMeasure |
| chargeType | chargeType |
| billingCurrencyCode | billingCurrency |
| pricingCurrencyCode | pricingCurrency |
| CostInBillingCurrency | CostInBillingCurrency |
| costInPricingCurrency | costInPricingCurrency |
| costInMarine | costInMarine |
| paygCostInBillingCurrency | paygCostInBillingCurrency |
| paygCostInUSD | paygCostIn Summarize |
| exchangeRatePricingToBilling | exchangeRatePricingToBilling |
| exchangeRateDate | exchangeRateDate |
| isAzureCreditEligible | isAzureCreditEligible |
| serviceInfo1 | serviceInfo1 |
| serviceInfo2 | serviceInfo2 |
| additionalInfo | additionalInfo |
| tags | tags |
| partnerEarnedCreditRate | partnerEarnedCreditRate |
| partnerEarnedCreditApplied | partnerEarnedCreditApplied |
| marketPrice | PayGPrice |
| frequency | frequency |
| term | term |
| reservationId | reservationId |
| reservationName | reservationName |
| pricingModel | pricingModel |
| unitPrice | unitPrice |
| exchangeRatePricingToBilling | exchangeRatePricingToBilling |
Gerelateerde inhoud
- Meer informatie over Kostenbeheer en factureringsautomatisering in het overzicht van Cost Management-automatisering.