Migreren vanuit Enterprise Agreement naar API’s voor Microsoft-klantovereenkomst
Dit artikel helpt u inzicht te krijgen in de verschillen in gegevensstructuur, API's en andere verschillen in de systeemintegratie tussen Enterprise Agreement-accounts (EA) en Microsoft-klantovereenkomsten-accounts (MCA). Cost Management ondersteunt API's voor beide accounttypen. Raadpleeg het artikel Uw factureringsrekening configureren voor een Microsoft-klantovereenkomst voordat u verdergaat.
Organisaties met een bestaand EA-account moeten dit artikel bekijken wanneer ze een MCA-account instellen. Voorheen bestond het vernieuwen van een EA-account uit een klein aantal handelingen om van een oude inschrijving op een nieuwe over te stappen. Voor het migreren naar een MCA-account is echter extra inspanning vereist. Extra inspanning is het gevolg van wijzigingen in het onderliggende factureringssubsysteem, die van invloed zijn op alle kostengerelateerde API's en serviceaanbiedingen.
MCA-API's en integratie
Met MCA-API's en de nieuwe integratie:
- Hebt u de volledige beschikking over API's via systeemeigen Azure-API's.
- Kunt u meerdere facturen configureren in één enkel factureringsaccount.
- Hebt u toegang tot een gecombineerd gebruik van API's en de Azure-service, kunt u gebruikmaken van een marktplaats van een derde partij en Marketplace-aankopen doen.
- Kosten weergeven voor factureringsprofielen (hetzelfde als inschrijvingen) met behulp van Cost Management.
- Kunt u nieuwe API's gebruiken om kosten weer te geven, meldingen ontvangen als kosten de vooraf gedefinieerde drempelwaarden overschrijden en onbewerkte gegevens automatisch exporteren.
Migratiecontrolelijst
De volgende items helpen u bij de overstap naar MCA-API's.
- Maak u vertrouwd met de nieuwe factureringsrekening van de Microsoft-klantovereenkomst.
- Bepaal welke API's u gebruikt en bekijk in de volgende sectie welke worden vervangen.
- Maak u vertrouwd met Azure Resource Manager REST API's.
- Als u nog geen Azure Resource Manager-API's gebruikt, registreert u uw client-app bij Microsoft Entra-id.
- Verdeel de toepassing die is gemaakt tijdens de registratie van Microsoft Entra-apps leestoegang tot de factureringsrekening met behulp van Toegangsbeheer (IAM).
- Werk elke programmeercode bij om Microsoft Entra-verificatie te gebruiken.
- Werk alle programmeercode bij om EA-API-aanroepen te vervangen door MCA-API-aanroepen.
- Foutafhandeling bijwerken om nieuwe foutcodes te gebruiken.
- Bekijk andere integratieaanbiedingen, zoals Power BI, voor andere benodigde actie.
EA-API's vervangen door MCA-API's
EA-API's gebruiken een API-sleutel voor verificatie en autorisatie. MCA-API's maken gebruik van Microsoft Entra-verificatie.
Notitie
Alle Azure Enterprise Reporting-API's worden buiten gebruik gesteld. U moet zo snel mogelijk migreren naar Microsoft Cost Management-API's .
| Doel | EA-API | MCA-API |
|---|---|---|
| Saldo en tegoeden | /balancesummary | Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae |
| Gebruik (JSON) | /usagedetails /usagedetailsbycustomdate |
Een oplossing voor kostendetails kiezen |
| Gebruik (CSV) | /usagedetails/download /usagedetails/submit |
Een oplossing voor kostendetails kiezen |
| Marketplace-gebruik (CSV) | /marketplacecharges /marketplacechargesbycustomdate |
Een oplossing voor kostendetails kiezen |
| Factureringsperioden | /billingperiods | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Prijzenoverzicht | /pricesheet | Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json of csv Microsoft.Billing/billingAccounts/.../billingProfiles/.../invoices/... /pricesheet/default/download format=json of csv Microsoft.Billing/billingAccounts/.. /billingProfiles/.. /providers/Microsoft.Consumption/pricesheets/download |
| Reserveringsaankopen | /reservationcharges | Microsoft.Billing/billingAccounts/billingProfiles/transactions |
| Aanbevelingen voor reserveringen | /SharedReservationRecommendations /SingleReservationRecommendations |
Microsoft.Consumption/reservationRecommendations |
| Reserveringsgebruik | /reservationdetails /reservationsummaries |
Microsoft.Consumption/reservationDetails Microsoft.Consumption/reservationSummaries |
¹ Azure-service en Marketplace-gebruik van derden zijn beschikbaar met de API voor gebruiksgegevens.
De volgende API's zijn beschikbaar voor MCA-factureringsaccounts:
| Doel | MCA-API (Microsoft-klantovereenkomst) |
|---|---|
| Factureringsrekeningen² | Microsoft.Billing/billingAccounts |
| Factureringsprofielen² | Microsoft.Billing/billingAccounts/billingProfiles |
| Factuursecties² | Microsoft.Billing/billingAccounts/invoiceSections |
| Facturen | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Factureringsabonnementen | {scope}/billingSubscriptions |
² API's retourneren lijsten met objecten, die bereiken zijn, waarbij Cost Management-ervaringen in Azure Portal en API's worden uitgevoerd. Zie Understand and work with scopes (Engelstalig) voor meer informatie over bereiken in Cost Management.
Als u bestaande EA-API's gebruikt, moet u deze bijwerken om ondersteuning te kunnen bieden voor MCA-factureringsaccounts. De volgende tabel bevat andere wijzigingen in de integratie:
| Doel | Oude aanbieding | Nieuwe aanbieding |
|---|---|---|
| Power BI | Microsoft Azure Consumption Insights-inhoudspakket en connector | Azure Consumption Insights-connector |
API's om saldo en tegoeden op te halen
Het overzicht Saldo ophalen is gebruikt om u een maandelijks overzicht te geven van:
- Tegoeden
- Nieuwe aankopen
- Servicekosten voor Azure Marketplace
- Aanpassingen
- Serviceoverschrijdingskosten
Alle verbruiks-API's worden vervangen door systeemeigen Azure-API's die gebruikmaken van Microsoft Entra-id voor verificatie en autorisatie. Zie Aan de slag met REST voor meer informatie over het aanroepen van REST API's.
De API voor het ophalen van saldi is vervangen door de API Microsoft.Billing/billingAccounts/billingProfiles/availableBalance.
Beschikbare saldi ophalen met de API voor het ophalen van beschikbare saldi:
| Wijze | Aanvraag-URI |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview |
API's voor het ophalen van kosten en gebruik
Ontvang een op dag uitgesplitst overzicht van het gebruik van Azure-services, het gebruik van een marktplaats van een derde partij en andere Marketplace-aankopen door de volgende API's te gebruiken. De volgende afzonderlijke API's zijn samengevoegd zodat ze kunnen worden gebruikt voor Azure-services en voor het gebruik van een marktplaats van een derde partij. De oude API's worden vervangen door exports of de API voor kostendetails. Zie Een oplossing voor kostendetails kiezen om de oplossing te kiezen die geschikt is voor u. Beide oplossingen bieden hetzelfde bestand met kostendetails en hebben Marketplace-aankopen in de gegevens, die eerder alleen werden weergegeven in het saldooverzicht tot heden.
Exports en de COST Details-API, net als bij alle Cost Management-API's, zijn beschikbaar op meerdere bereiken. Gebruik, net als doorgaans bij een inschrijvingsniveau, voor gefactureerde kosten het bereik van het factureringsprofiel. Zie Understand and work with scopes (Engelstalig) voor meer informatie over bereiken in Cost Management.
| Type | Id-indeling |
|---|---|
| Factureringsaccount | /Microsoft.Billing/billingAccounts/{billingAccountId} |
| Factureringsprofiel | /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} |
| Abonnement | /subscriptions/{subscriptionId} |
| Resourcegroep | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName} |
Sommige eigenschapsnamen zijn gewijzigd in de nieuwe gegevensset Cost Details die beschikbaar is via de EXPORT- en Cost Details-API. In de volgende tabel worden de bijbehorende eigenschappen weergegeven.
| Oude eigenschap | Nieuwe eigenschap | Opmerkingen |
|---|---|---|
| AccountId | N.v.t. | De maker van het abonnement wordt niet bijgehouden. Gebruik invoiceSectionId (hetzelfde als departmentId). |
| AccountNameAccountOwnerId en AccountOwnerEmail | N.v.t. | De maker van het abonnement wordt niet bijgehouden. Gebruik invoiceSectionName (hetzelfde als departmentName). |
| AdditionalInfo | additionalInfo | |
| ChargesBilledSeparately | isAzureCreditEligible | De eigenschappen zijn tegengestelden. Als isAzureCreditEnabled is ingesteld op waar, wordt ChargesBilledSeparately onwaar. |
| ConsumedQuantity | quantity | |
| ConsumedService | consumedService | De exacte tekenreekswaarden kunnen verschillen. |
| ConsumedServiceId | Geen | |
| CostCenter | costCenter | |
| Date en usageStartDate | datum | |
| Dag | Geen | Begindatum van parseren dag. |
| DepartmentId | invoiceSectionId | De exacte waarden verschillen. |
| DepartmentName | invoiceSectionName | De exacte tekenreekswaarden kunnen verschillen. Zo nodig kunt u factuursecties configureren, zodat deze overeenkomen met afdelingen. |
| ExtendedCost en Cost | CostInBillingCurrency | |
| InstanceId | resourceId | |
| Zijn terugkerende kosten | Geen | |
| Locatie | locatie | |
| MeterCategory | meterCategory | De exacte tekenreekswaarden kunnen verschillen. |
| MeterId | meterId | De exacte tekenreekswaarden verschillen. |
| MeterName | meterName | De exacte tekenreekswaarden kunnen verschillen. |
| MeterRegion | meterRegion | De exacte tekenreekswaarden kunnen verschillen. |
| MeterSubCategory | meterSubCategory | De exacte tekenreekswaarden kunnen verschillen. |
| Month | Geen | Begindatum van parseren maand. |
| Naam van aanbieding | Geen | Gebruik publisherName en productOrderName. |
| OfferID | Geen | |
| Ordernummer | Geen | |
| PartNumber | Geen | Gebruik meterId en productOrderName om prijzen uniek aan te duiden. |
| Naam van het plan | productOrderName | |
| Product | Product | |
| Product-id | productId | De exacte tekenreekswaarden verschillen. |
| Naam van de uitgever | publisherName | |
| ResourceGroup | resourceGroupName | |
| ResourceGuid | meterId | De exacte tekenreekswaarden verschillen. |
| ResourceLocation | resourceLocation | |
| ResourceLocationId | Geen | |
| ResourceName | Geen | |
| ResourceRate | effectivePrice | |
| ServiceAdministratorId | N.v.t. | |
| ServiceInfo1 | serviceInfo1 | |
| ServiceInfo2 | serviceInfo2 | |
| ServiceName | meterCategory | De exacte tekenreekswaarden kunnen verschillen. |
| ServiceTier | meterSubCategory | De exacte tekenreekswaarden kunnen verschillen. |
| StoreServiceIdentifier | N.v.t. | |
| SubscriptionGuid | subscriptionId | |
| SubscriptionId | subscriptionId | |
| SubscriptionName | subscriptionName | |
| Tags | tags | De eigenschap tags is van toepassing op het hoofdobject, niet op de geneste eigenschappen. |
| UnitOfMeasure | unitOfMeasure | De exacte tekenreekswaarden verschillen. |
| usageEndDate | datum | |
| Year | Geen | Begindatum van parseren jaar. |
| (nieuw) | billingCurrency | De valuta die wordt gebruikt voor de kosten. |
| (nieuw) | billingProfileId | De unieke id voor het factureringsprofiel (hetzelfde als inschrijving). |
| (nieuw) | billingProfileName | Naam van het factureringsprofiel (hetzelfde als inschrijving). |
| (nieuw) | chargeType | Gebruik deze om onderscheid te maken tussen het gebruik van Azure-services, het gebruik van Marketplace en aankopen. |
| (nieuw) | InvoiceId | De unieke id voor de factuur. Leeg voor de huidige, open maand. |
| (nieuw) | publisherType | Het type uitgever voor aankopen. Leeg voor gebruik. |
| (nieuw) | serviceFamily | Type aankoop. Leeg voor gebruik. |
| (nieuw) | servicePeriodEndDate | Einddatum voor de aangeschafte service. |
| (nieuw) | servicePeriodStartDate | Begindatum voor de aangeschafte service. |
API voor factureringsperioden is vervangen door API voor facturen:
MCA-factureringsaccounts gebruiken geen factureringsperioden. In plaats daarvan worden er facturen gebruikt om het bereik van de kosten te beperken tot specifieke factureringsperioden. De API voor factureringsperioden is vervangen door de API voor facturen: Alle verbruiks-API's worden vervangen door systeemeigen Azure-API's die gebruikmaken van Microsoft Entra-id voor verificatie en autorisatie. Zie Aan de slag met REST voor meer informatie over het aanroepen van REST API's.
Facturen ophalen met de API voor facturen:
| Wijze | Aanvraag-URI |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview |
API's voor prijzenoverzichten
In deze sectie worden de bestaande API's voor prijzenoverzichten besproken en worden aanbevelingen gedaan voor de overstap naar de API voor prijzenoverzichten voor Microsoft-klantovereenkomsten. Ook wordt de API voor prijzenoverzichten voor Microsoft-klantovereenkomsten beschreven en worden de velden in de prijzenoverzichten uitgelegd. De API's ophalen van prijzenoverzicht voor Enterprise-klanten en factureringsperioden ophalen voor Enterpise-klanten worden vervangen door de API voor prijzenoverzichten voor Microsoft-klantovereenkomsten (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). De nieuwe API biedt zowel ondersteuning voor JSON- als CSV-indelingen, in asynchrone REST-indelingen. Alle verbruiks-API's worden vervangen door systeemeigen Azure-API's die gebruikmaken van Microsoft Entra-id voor verificatie en autorisatie. Zie Aan de slag met REST voor meer informatie over het aanroepen van REST API's.
Facturerings-API's voor Enterprise-klanten
U hebt facturerings-API's voor Enterprise-klanten gebruikt met Enterprise-inschrijvingen voor het ophalen van gegevens over de prijs en de factureringsperiode. Verificatie en autorisatie gebruikt Microsoft Entra-webtokens.
De juiste prijzen ophalen voor de opgegeven Enterprise-inschrijving met de AP's voor prijzenoverzichten en de API voor het ophalen van de factureringsperiode:
| Wijze | Aanvraag-URI |
|---|---|
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet |
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet |
API voor prijzenoverzichten voor Microsoft-klantovereenkomst
Gebruik de API voor prijzenoverzichten voor Microsoft-klantovereenkomsten om de prijzen voor alle verbruiksservices van Azure en Marketplace te bekijken. De prijzen die voor het factureringsprofiel worden weergegeven, zijn van toepassing op alle abonnementen die deel uitmaken van het factureringsprofiel.
Gebruik de API voor prijzenoverzichten om alle gegevens van prijzenoverzichten voor alle verbruiksservices van Azure in CSV-indeling weer te geven:
| Wijze | Aanvraag-URI |
|---|---|
| POSTEN | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=csv |
Gebruik de API voor prijzenoverzichten om alle gegevens van prijzenoverzichten voor alle verbruiksservices van Azure in JSON-indeling weer te geven:
| Wijze | Aanvraag-URI |
|---|---|
| POSTEN | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=json |
Met de API wordt het prijzenoverzicht voor het hele account geretourneerd. U kunt echter ook een verkorte versie van het prijzenoverzicht in PDF-indeling krijgen. Het overzicht omvat gegevens over verbruiksservices van Azure en Marketplace die met een specifieke factuur worden gefactureerd. De factuur wordt aangeduid met de {invoiceId}, die gelijk is aan het factuurnummer, en wordt weergegeven in de PDF-bestanden met de factuuroverzichten. Dit is een voorbeeld.
Factuurgegevens weergeven in CSV-indeling met de API voor prijzenoverzichten:
| Wijze | Aanvraag-URI |
|---|---|
| POSTEN | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Factuurgegevens weergeven in JSON-indeling met de API voor prijzenoverzichten:
| Wijze | Aanvraag-URI |
|---|---|
| POSTEN | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
U kunt ook geschatte prijzen bekijken voor elke verbruiksservice van Azure en Marketplace in de huidige openstaande factureringscyclus of serviceperiode.
Geschatte prijzen voor verbruiksservices weergeven in CSV-indeling met de API voor prijzenoverzichten:
| Wijze | Aanvraag-URI |
|---|---|
| POSTEN | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Geschatte prijzen voor verbruiksservices weergeven in JSON-indeling met de API voor prijzenoverzichten:
| Wijze | Aanvraag-URI |
|---|---|
| POSTEN | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
De API's voor prijzenoverzichten voor Microsoft-klantovereenkomsten zijn asynchrone REST API's. De reacties voor de API's zijn gewijzigd ten opzichte van de oudere synchrone API's. De hoofdtekst van de reactie van de API is ook gewijzigd.
Oude hoofdtekst van de reactie
Hier volgt een voorbeeld van een reactie van de synchrone REST API:
[
{
"id": "enrollments/573549891/billingperiods/2016011/products/343/pricesheets",
"billingPeriodId": "201704",
"meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
"meterName": "A1 VM",
"unitOfMeasure": "100 Hours",
"includedQuantity": 0,
"partNumber": "N7H-00015",
"unitPrice": 0.00,
"currencyCode": "USD"
},
{
]
Nieuwe hoofdtekst van de reactie
De API's bieden ondersteuning voor de asynchrone Azure REST-indeling. Als de API wordt aangeroepen met GET, ontvangt u de volgende reactie:
No Response Body
HTTP Status 202 Accepted
De volgende headers worden verzonden met de locatie van de uitvoer:
Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Azure-AsyncOperation:https://managment.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Retry-After: 10
OData-EntityId: {operationId}
Maak een andere GET-aanroep naar de locatie. De reactie op de GET-aanroep is hetzelfde ongeacht of de bewerking kan worden voltooid of niet. Wanneer dit is voltooid, retourneert het antwoord op de GET-oproeplocatie de download-URL alsof de bewerking tegelijkertijd is uitgevoerd. Hier volgt een voorbeeld:
HTTP Status 200
{
"id": "providers/Microsoft.Consumption/operationresults/{operationId}",
"name": {operationId},
"type": “Microsoft.Consumption/operationResults",
"properties" : {
"downloadUrl": {urltoblob},
"validTill": "Date"
}
}
De client kan ook een GET-aanroep uitvoeren voor de Azure-AsyncOperation. Het eindpunt retourneert de status van de bewerking.
De volgende tabel bevat velden in de oudere API voor het ophalen van prijzenoverzichten voor Enterprise-klanten. De tabel bevat overeenkomende velden in het nieuwe prijzenoverzicht voor Microsoft-klantovereenkomsten:
| Oude eigenschap | Nieuwe eigenschap | Opmerkingen |
|---|---|---|
| billingPeriodId | Niet van toepassing | Niet van toepassing. Voor Microsoft-klantovereenkomsten is het concept van billingPeriodId vervangen door de factuur en het bijbehorende prijzenoverzicht. |
| meterId | meterId | |
| unitOfMeasure | unitOfMeasure | De exacte tekenreekswaarden kunnen verschillen. |
| includedQuantity | includedQuantity | Niet van toepassing op services in Microsoft-klantovereenkomsten. |
| partNumber | Niet van toepassing | Gebruik in plaats daarvan een combinatie van productOrderName (hetzelfde als offerID) en meterID. |
| unitPrice | unitPrice | Eenheidsprijs is niet van toepassing op services die worden verbruikt als onderdeel van Microsoft-klantovereenkomsten. |
| currencyCode | pricingCurrency | In Microsoft-klantovereenkomsten worden prijzen weergegeven in de prijsvaluta en factureringsvaluta. In Microsoft-klantovereenkomsten komen de currencyCode en de pricingCurrency met elkaar overeen. |
| offerID | productOrderName | In plaats van OfferID kunt u productOrderName gebruiken, maar dit is niet hetzelfde als de OfferID. ProductOrderName en meter bepalen de prijzen in Microsoft-klantovereenkomsten met betrekking tot meterId en OfferID in verouderde inschrijvingen. |
Bewerkingen van de API voor prijzenoverzichten voor verbruik
Voor Enterprise-overeenkomsten hebt u de bewerkingen Ophalen en Ophalen per factureringsperiode gebruikt voor een bereik op subscriptionId of factureringsperiode. De API maakt gebruik van verificatie door Azure Resource Management.
De informatie van een prijzenoverzicht ophalen voor een bereik met de API voor het prijzenoverzicht:
| Wijze | Aanvraag-URI |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Informatie van een prijzenoverzicht ophalen per factureringsperiode met de API voor het prijzenoverzicht:
| Wijze | Aanvraag-URI |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Gebruik voor Microsoft-klantovereenkomsten in plaats van de bovenstaande API-eindpunten de volgende:
API's voor prijzenoverzichten voor Microsoft-klantovereenkomsten (asynchrone REST API)
Deze API is bedoeld voor Microsoft-klantovereenkomst s en biedt extra kenmerken.
Prijzenoverzicht voor een factureringsprofielbereik in een factureringsaccount
Deze API is de bestaande API. Deze is bijgewerkt om het prijzenoverzicht voor een factureringsprofiel in een factureringsaccount te verkrijgen.
Prijzenoverzicht voor een bereik per factureringsaccount
Verificatie van Azure Resource Manager wordt gebruikt wanneer u het prijzenoverzicht in het inschrijvingsbereik in een factureringsaccount ophaalt.
Het prijzenoverzicht ophalen bij het inschrijvingsaccount in een factureringsaccount:
| Wijze | Aanvraag-URI |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
Voor een Microsoft-klantovereenkomst gebruikt u de informatie in de volgende sectie. Deze bevat de veldeigenschappen die worden gebruikt voor Microsoft-klantovereenkomsten.
Prijzenoverzicht voor een factureringsprofielbereik in een factureringsaccount
Het bijgewerkte prijzenoverzicht per factureringsaccount-API haalt het prijzenoverzicht op in CSV-indeling. U kunt als volgt het prijzenoverzicht voor het factureringsprofiel voor een MCA ophalen:
| Wijze | Aanvraag-URI |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
Bij het inschrijvingsbereik van EA zijn de API-reactie en eigenschappen identiek. De eigenschappen komen overeen met dezelfde MCA-eigenschappen.
De oudere eigenschappen voor API's voor prijzenoverzichten van Azure Resource Manager en de overeenkomstige nieuwe eigenschappen bevinden zich in de volgende tabel.
| Oude eigenschap van API voor prijzenoverzichten van Azure Resource Manager | Nieuwe eigenschap van API voor prijzenoverzichten voor Microsoft-klantovereenkomsten | Beschrijving |
|---|---|---|
| Id van de meter | meterId | Unieke identificatie voor de meter. Hetzelfde als meterID. |
| Meternaam | meterName | Naam van de meter. De meter vertegenwoordigt de implementeerbare resource van een Azure-service. |
| Metercategorie | service | Naam van de classificatiecategorie voor de meter. Dezelfde als de service in uw prijzenoverzicht voor een Microsoft-klantovereenkomst. De exacte tekenreekswaarden verschillen. |
| Subcategorie van de meter | meterSubCategory | De naam van de subclassificatiecategorie voor de meter. Op basis van de classificatie van de differentiatie op algemeen niveau van de functieset in de service. Bijvoorbeeld: Basic SQL DB versus Standard SQL DB. |
| De regio van de meter | meterRegion | |
| Eenheid | Niet van toepassing | Kan worden geparseerd vanuit unitOfMeasure. |
| Maateenheid | unitOfMeasure | |
| Onderdeelnummer | Niet van toepassing | Gebruik productOrderName en MeterID in plaats van het onderdeelnummer als unieke identificatie van de prijs van een factureringsprofiel. Velden worden op de MCA-factuur weergegeven in plaats van het onderdeelnummer op MCA-facturen. |
| Prijs per eenheid | unitPrice | Eenheidsprijs in Microsoft-klantovereenkomst. |
| Valutacode | pricingCurrency | In Microsoft-klantovereenkomsten worden prijzen weergegeven in prijsvaluta en factureringsvaluta. In Microsoft-klantovereenkomsten komen de valutacode en de pricingCurrency met elkaar overeen. |
| Inbegrepen hoeveelheid | includedQuantity | Niet van toepassing op services in Microsoft-klantovereenkomsten. Worden weergegeven met waarden van nul. |
| Aanbiedings-id | productOrderName | Gebruik productOrderName in plaats van OfferID. Niet hetzelfde als OfferID, maar de productOrderName en meter bepalen prijzen in Microsoft-klantovereenkomsten. Gerelateerd aan meterId en OfferID in verouderde inschrijvingen. |
De prijs voor Microsoft-klantovereenkomsten is anders gedefinieerd dan die voor Enterprise-overeenkomsten. De prijs voor services in de Enterprise-inschrijving is uniek voor het product, het onderdeelnummer, de meter en de aanbieding. Het onderdeelnummer wordt niet gebruikt in Microsoft-klantovereenkomsten.
De prijs van de Azure-verbruiksservice die deel uitmaakt van een Microsoft-klantovereenkomst is uniek voor productOrderName en meterID. Ze vertegenwoordigen de servicemeter en het productabonnement.
Voor afstemming tussen het prijzenoverzicht en het gebruik in de API voor gedetailleerde gebruiksgegevens, kunt u de productOrderName en meterID gebruiken.
Gebruikers met de rechten van een factureringsprofieleigenaar, inzender, lezer en factuurbeheerder kunnen het prijzenoverzicht downloaden.
Het prijzenoverzicht bevat prijzen voor services waarvoor de prijs is gebaseerd op gebruik. De services omvatten Azure-verbruik en Marketplace-verbruik. De meest recente prijs aan het einde van elke serviceperiode is vergrendeld en wordt toegepast op het gebruik in één serviceperiode. Voor Azure-verbruiksservices is de serviceperiode doorgaans een kalendermaand.
Buiten gebruik gestelde velden in de API voor prijzenoverzichten
De volgende velden zijn niet beschikbaar in de API's voor prijzenoverzichten voor Microsoft-klantovereenkomsten of ze hebben dezelfde velden.
| Buiten gebruik gesteld veld | Beschrijving |
|---|---|
| billingPeriodId | Niet van toepassing. Komt overeen met InvoiceId voor MCA. |
| offerID | Niet van toepassing. Komt overeen met productOrderName in MCA. |
| meterCategory | Niet van toepassing. Komt overeen met Service in MCA. |
| eenheid | Niet van toepassing. Kan worden geparseerd vanuit unitOfMeasure. |
| currencyCode | Hetzelfde als de pricingCurrency in MCA. |
| meterLocation | Hetzelfde als de meterRegion in MCA. |
| partNumber | Niet van toepassing want het onderdeelnummer wordt niet vermeld op MCA-facturen. Gebruik de combinatie van meterId en productOrderName in plaats van het onderdeelnummer voor het uniek identificeren van prijzen. |
| totalIncludedQuantity | Niet van toepassing. |
| pretaxStandardRate | Niet van toepassing. |
De API voor kosten van gereserveerde instanties is vervangen
U kunt factureringstransacties ophalen voor reserveringsaankopen met de API voor kosten van gereserveerde instanties. Met de nieuwe API kunnen alle aankopen worden opgehaald, inclusief aanbiedingen op een marktplaats van derden. Alle verbruiks-API's worden vervangen door systeemeigen Azure-API's die gebruikmaken van Microsoft Entra-id voor verificatie en autorisatie. Zie Aan de slag met REST voor meer informatie over het aanroepen van REST API's. De API voor kosten van gereserveerde instanties is vervangen door de API voor transacties.
Reserveringsaankopen ophalen met de API voor transacties:
| Wijze | Aanvraag-URI |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview |
API's voor aanbevelingen vervangen
Met API's voor aankoopaanbevelingen voor gereserveerde instanties wordt het gebruik van virtuele machines gedurende de afgelopen 7, 30 of 60 dagen opgehaald. Met API's kunnen ook aanbevelingen voor reserveringsaankopen worden opgehaald. Deze omvatten:
- API voor aanbevelingen voor gedeelde gereserveerde instanties
- API voor aanbevelingen voor individuele gereserveerde instanties
Alle verbruiks-API's worden vervangen door systeemeigen Azure-API's die gebruikmaken van Microsoft Entra-id voor verificatie en autorisatie. Zie Aan de slag met REST voor meer informatie over het aanroepen van REST API's. De eerder vermelde API's voor aanbevelingen voor reserveringen worden vervangen door de API Microsoft.Consumption/reservationRecommendations.
Reserveringsaanbevelingen ophalen met de API voor aanbevelingen voor reserveringen:
| Wijze | Aanvraag-URI |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01 |
De API voor reserveringsgebruik is vervangen
U kunt het reserveringsgebruik in een inschrijving ophalen met de API voor reserveringsgebruik. Als er meer dan een gereserveerde instantie voorkomt in een inschrijving, kunt u met deze API ook het gebruik van alle aankopen voor gereserveerde instanties ophalen.
Deze omvatten:
- Details van het gebruik van gereserveerde instanties
- Samenvatting van het gebruik van gereserveerde instanties
Alle verbruiks-API's worden vervangen door systeemeigen Azure-API's die gebruikmaken van Microsoft Entra-id voor verificatie en autorisatie. Zie Aan de slag met REST voor meer informatie over het aanroepen van REST API's. De eerder vermelde API's voor aanbevelingen voor reserveringen worden vervangen door de API's Microsoft.Consumption/reservationDetails en Microsoft.Consumption/reservationSummaries.
Details van reserveringen ophalen met de API voor reserveringsdetails:
| Wijze | Aanvraag-URI |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01 |
Samenvattingen van reserveringen ophalen met de API voor reserveringssamenvattingen:
| Wijze | Aanvraag-URI |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01 |
Power BI-integratie
U kunt ook Power BI voor het rapporteren van kosten gebruiken. De Cost Management-connector voor Power BI Desktop kan worden gebruikt om krachtige, aangepaste rapporten te maken die u helpen uw Azure-uitgaven beter te begrijpen. De Cost Management-connector ondersteunt momenteel klanten met een Microsoft-klantovereenkomst of een Enterprise Overeenkomst (EA).
Gerelateerde inhoud
- Lees de documentatie voor Cost Management voor meer informatie over het bewaken en beheren van uitgaven voor Azure. Of als u uw gebruik van resources wilt optimaliseren met behulp van Cost Management.