Migrera från Enterprise-avtal till API:er för Microsoft-kundavtal
Den här artikeln hjälper dig att förstå skillnaderna vad gäller datastrukturer, API:er och annan systemintegrering mellan konton med Enterprise-avtal (EA) och Microsoft-kundavtal (MCA). Cost Management stöder API:er för båda kontotyperna. Läs gärna artikeln Konfigurera faktureringskontot för Microsoft-kundavtal innan du fortsätter.
Organisationer med ett befintligt EA-konto bör granska den här artikeln när de konfigurerar ett MCA-konto. När du tidigare skulle förnya ett EA-konto krävdes en liten mängd arbete för att flytta från en gammal registrering till en ny. Att migrera till ett MCA-konto kräver dock extra arbete. Extra arbete beror på ändringar i det underliggande faktureringsundersystemet, vilket påverkar alla kostnadsrelaterade API:er och tjänsterbjudanden.
API:er för MCA och integrering
Med API:erna för MCA och den nya integreringen kan du:
- Få fullständig API-tillgänglighet via API:er som är inbyggda i Azure.
- Konfigurera flera fakturor på ett enda faktureringskonto.
- Få åtkomst till ett kombinerat API med användning av Azure-tjänster samt använda tredjepartstjänster och göra inköp på Marketplace.
- Visa kostnader mellan faktureringsprofiler (samma som registreringar) med Hjälp av Cost Management.
- Få till gång till nya API:er som visar kostnader, få aviseringar när kostnaderna överstiger fördefinierade tröskelvärden och exportera rådata automatiskt.
Checklista för migrering
De här punkterna hjälper dig med övergången till API:erna för MCA.
- Bekanta dig med det nya faktureringskontot för Microsoft-kundavtal.
- Fastställ vilka API:er du använder och se vilka som ersätts i följande avsnitt.
- Bekanta dig med REST-API:erna för Azure Resource Manager.
- Om du inte redan använder Azure Resource Manager-API:er registrerar du din klientapp med Microsoft Entra-ID.
- Bevilja programmet som skapades under Microsoft Entra-appregistrering läsbehörighet till faktureringskontot med hjälp av åtkomstkontroll (IAM).
- Uppdatera all programmeringskod för att använda Microsoft Entra-autentisering.
- Uppdatera eventuell programmeringskod och ersätt API-anrop för EA med API-anrop för MCA.
- Uppdatera felhanteringen så att du använder de nya felkoderna.
- Granska andra integreringserbjudanden som Power BI för andra nödvändiga åtgärder.
API:er för EA som ersätts med API:er för MCA
I API:erna för EA används en API-nyckel autentisering och auktorisering. MCA-API:er använder Microsoft Entra-autentisering.
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.
| Syfte | EA-API | MCA-API |
|---|---|---|
| Saldo och krediter | /balancesummary | Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae |
| Användning (JSON) | /usagedetails /usagedetailsbycustomdate |
Välj en lösning för kostnadsinformation |
| Användning (CSV) | /usagedetails/download /usagedetails/submit |
Välj en lösning för kostnadsinformation |
| Marketplace-användning (CSV) | /marketplacecharges /marketplacechargesbycustomdate |
Välj en lösning för kostnadsinformation |
| Faktureringsperioder | /billingperiods | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Prisdokument | /pricesheet | Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json eller csv Microsoft.Billing/billingAccounts/.../billingProfiles/.../invoices/... /pricesheet/default/download format=json eller csv Microsoft.Billing/billingAccounts/.. /billingProfiles/.. /providers/Microsoft.Consumption/pricesheets/download |
| Reservationsköp | /reservationcharges | Microsoft.Billing/billingAccounts/billingProfiles/transactions |
| Reservationsrekommendationer | /SharedReservationRecommendations /SingleReservationRecommendations |
Microsoft.Consumption/reservationRecommendations |
| Reservationsanvändning | /reservationdetails /reservationsummaries |
Microsoft.Consumption/reservationDetails Microsoft.Consumption/reservationSummaries |
¹ Azure-tjänsten och marketplace-användningen från tredje part är tillgängliga med API:et för användningsinformation.
De här API:erna är tillgängliga för MCA-faktureringskonton:
| Syfte | MCA-API (Microsoft-kundavtal) |
|---|---|
| Faktureringskonton² | Microsoft.Billing/billingAccounts |
| Faktureringsprofiler² | Microsoft.Billing/billingAccounts/billingProfiles |
| Fakturaavsnitt² | Microsoft.Billing/billingAccounts/invoiceSections |
| Fakturor | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| Faktureringsprenumerationer | {scope}/billingSubscriptions |
²-API:er returnerar listor över objekt, som är omfång, där Cost Management-funktioner i Azure Portal och API:er fungerar. Du kan läsa mer om Cost Management-omfång i Förstå och arbeta med omfång.
Om du använder några befintliga EA-API:er måste du uppdatera dem så att de fungerar med MCA-faktureringskonton. I den här tabellen visas ytterligare integreringsändringar:
| Syfte | Gammalt erbjudande | Nytt erbjudande |
|---|---|---|
| Power BI | Innehållspaket och anslutningsprogram för Microsoft Consumption Insights | Anslutningsprogram för Azure Consumption Insights |
API:er för att få saldo och krediter
Get Balance-sammanfattningen användes för att ge dig en månatlig sammanfattning av:
- Saldon
- Nya inköp
- Avgifter för tjänster på Azure Marketplace
- Justeringar
- Avgifter för överförbrukning av tjänster
Alla förbruknings-API:er ersätts av interna Azure-API:er som använder Microsoft Entra-ID för autentisering och auktorisering. Du kan läsa mer om att anropa Azures REST-API:er i Komma igång med REST.
API:et för att hämta saldoöversikt ersätts av API:et Microsoft.Billing/billingAccounts/billingProfiles/availableBalance.
Så här hämtar du tillgängliga saldon via API:et för tillgängligt saldo:
| Metod | URI för förfrågan |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview |
API:er för att hämta kostnader och användning
Få en daglig översikt över kostnader för användning av Azure-tjänster, Marketplace-användning från tredje part och andra Marketplace-inköp via följande API:er. Följande separata API:er har slagits samman för Azure-tjänster och Marketplace-användning från tredje part. De gamla API:erna ersätts av antingen Exporter eller API:et för kostnadsinformation. Information om hur du väljer den lösning som passar dig finns i Välj en lösning för kostnadsinformation. Båda lösningarna tillhandahåller samma kostnadsinformationsfil och har marketplace-köp i data, som tidigare bara visades i saldosammanfattningen hittills.
Exporter och API:et för kostnadsinformation, precis som med alla Cost Management-API:er, är tillgängliga i flera omfång. När det gäller fakturerade kostnader som du normalt skulle debiteras på registreringsnivå ska du använda faktureringsprofilen som omfång. Du kan läsa mer om Cost Management-omfång i Förstå och arbeta med omfång.
| Typ | ID-format |
|---|---|
| Faktureringskonto | /Microsoft.Billing/billingAccounts/{billingAccountId} |
| Faktureringsprofil | /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} |
| Prenumeration | /subscriptions/{subscriptionId} |
| Resursgrupp | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName} |
Vissa egenskapsnamn har ändrats i den nya kostnadsinformationsdatauppsättningen som är tillgänglig via export- och kostnadsinformations-API:et. I den här tabellen visas motsvarande egenskaper.
| Gammal egenskap | Ny egenskap | Kommentar |
|---|---|---|
| AccountId | Ej tillämpligt | Den som skapat prenumerationen spåras inte. Använd invoiceSectionId (samma som departmentId). |
| AccountNameAccountOwnerId och AccountOwnerEmail | Ej tillämpligt | Den som skapat prenumerationen spåras inte. Använd invoiceSectionName (samma som departmentName). |
| AdditionalInfo | additionalInfo | |
| ChargesBilledSeparately | isAzureCreditEligible | Egenskaperna är motsatser. Om isAzureCreditEnabled är sann skulle ChargesBilledSeparately vara falsk. |
| ConsumedQuantity | kvantitet | |
| ConsumedService | consumedService | De exakta strängvärdena kan variera. |
| ConsumedServiceId | Ingen | |
| CostCenter | costCenter | |
| Date och usageStartDate | datum | |
| Dag | Ingen | Parsar dag och datum. |
| DepartmentId | invoiceSectionId | Exakta värden kan variera. |
| DepartmentName | invoiceSectionName | De exakta strängvärdena kan variera. Konfigurera fakturaavsnitten så att de matchar avdelningarna om det behövs. |
| ExtendedCost och Cost | costInBillingCurrency | |
| InstanceId | resourceId | |
| Är en återkommande avgift | Ingen | |
| Plats | plats | |
| MeterCategory | meterCategory | De exakta strängvärdena kan variera. |
| MeterId | meterId | De exakta strängvärdena varierar. |
| MeterName | meterName | De exakta strängvärdena kan variera. |
| MeterRegion | meterRegion | De exakta strängvärdena kan variera. |
| MeterSubCategory | meterSubCategory | De exakta strängvärdena kan variera. |
| Månad | Ingen | Parsar månad från datum. |
| Erbjudandets namn | Ingen | Använd publisherName och productOrderName. |
| OfferID | Ingen | |
| Ordernummer | Ingen | |
| PartNumber | Ingen | Använd meterId och productOrderName till att identifiera priser unikt. |
| Plannamn | productOrderName | |
| Produkt | Produkt | |
| Produkt-ID | productId | De exakta strängvärdena varierar. |
| Utgivarens namn | publisherName | |
| ResourceGroup | resourceGroupName | |
| ResourceGuid | meterId | De exakta strängvärdena varierar. |
| ResourceLocation | resourceLocation | |
| ResourceLocationId | Ingen | |
| ResourceName | Ingen | |
| ResourceRate | effectivePrice | |
| ServiceAdministratorId | Ej tillämpligt | |
| ServiceInfo1 | serviceInfo1 | |
| ServiceInfo2 | serviceInfo2 | |
| ServiceName | meterCategory | De exakta strängvärdena kan variera. |
| ServiceTier | meterSubCategory | De exakta strängvärdena kan variera. |
| StoreServiceIdentifier | Ej tillämpligt | |
| SubscriptionGuid | subscriptionId | |
| SubscriptionId | subscriptionId | |
| SubscriptionName | subscriptionName | |
| Taggar | taggar | Egenskapen tags gäller för rotobjektet, inte för egenskapernas kapslade egenskap. |
| UnitOfMeasure | unitOfMeasure | De exakta strängvärdena varierar. |
| usageEndDate | datum | |
| Year | Ingen | Parsar år från datum. |
| (nytt) | billingCurrency | Valuta som använts för avgiften. |
| (nytt) | billingProfileId | Unikt ID för faktureringsprofilen (samma som registreringen). |
| (nytt) | billingProfileName | Namn för faktureringsprofilen (samma som registreringen). |
| (nytt) | chargeType | Använd för att differentiera användningen av Azure-tjänster, Marketplace-användning och inköp. |
| (nytt) | invoiceId | Unikt ID för fakturan. Tomt för den aktuella, öppna månaden. |
| (nytt) | publisherType | Typ av utgivare för inköp. Tom för användning. |
| (nytt) | serviceFamily | Typ av köp. Tom för användning. |
| (nytt) | servicePeriodEndDate | Slutdatum för den köpta tjänsten. |
| (nytt) | servicePeriodStartDate | Startdatum för den köpta tjänsten. |
API:et Billing Periods ersätts med API:et Invoices
MCA-faktureringskonton använder inte faktureringsperioder. I stället används fakturor till att matcha kostnader mot specifika faktureringsperioder. API:et Billing Periods ersätts av API:et Invoices. Alla förbruknings-API:er ersätts av interna Azure-API:er som använder Microsoft Entra-ID för autentisering och auktorisering. Du kan läsa mer om att anropa Azures REST-API:er i Komma igång med REST.
Så här hämtar du fakturor med API:et Invoices:
| Metod | URI för förfrågan |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview |
API:er för prisdokument
I det här avsnittet går vi igenom befintliga API:er för prisdokument och ger rekommendationer för övergången till API:et Price Sheet för Microsoft-kundavtal. Dessutom går vi igenom API:et Price Sheet för Microsoft-kundavtal och fälten i prisdokumenten. API:erna Enterprise Get price sheet och Enterprise Get billing periods ersätts av API:et Price Sheet för Microsoft-kundavtal (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet). Det nya API:et har stöd för både JSON- och CSV-format i asynkrona REST-format. Alla förbruknings-API:er ersätts av interna Azure-API:er som använder Microsoft Entra-ID för autentisering och auktorisering. Du kan läsa mer om att anropa Azures REST-API:er i Komma igång med REST.
API:er för Enterprise-fakturering
Tidigare har du använt API:erna för Enterprise-fakturering med Enterprise-registreringar för att få information om priser och faktureringsperioder. Autentisering och auktorisering använde Microsoft Entra-webbtoken.
Så här hämtar du gällande priser för den angivna Enterprise-registreringen med API:erna Price Sheet och Billing Period:
| Metod | URI för förfrågan |
|---|---|
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet |
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet |
API:et Price Sheet för Microsoft-kundavtal
Använd API:et Price Sheet för Microsoft-kundavtal till att se priser för alla förbrukningstjänster i Azure och på Marketplace. Priserna som visas för faktureringsprofilen gäller för alla prenumerationer som tillhör faktureringsprofilen.
Använd API:et Price Sheet till att visa prisdokumentsdata för alla Azure-förbrukningstjänster i CSV-format:
| Metod | URI för förfrågan |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=csv |
Använd API:et Price Sheet till att visa prisdokumentsdata för alla Azure-förbrukningstjänster i CSV-format:
| Metod | URI för förfrågan |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=json |
Med API:et returneras prisdokumentet för hela kontot. Men du kan också få en komprimerad version av prisdokumentet i PDF-format. I sammanfattningen ingår Azure-förbrukning och Marketplace-tjänster som faktureras på en viss faktura. Fakturan identifieras av {invoiceId}, som är samma som fakturanumret i PDF-filerna med fakturasammanfattningen. Här följer ett exempel.
Så här visar du fakturainformation via API:et Price Sheet i CSV-format:
| Metod | URI för förfrågan |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Så här visar du fakturainformation via API:et Price Sheet i JSON-format:
| Metod | URI för förfrågan |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
Du kan också se uppskattade priser för förbrukning i Azure och på Marketplace i den aktuella öppna faktureringsperioden eller tjänstperioden.
Så här visar du uppskattade priser för förbrukningstjänster via API:et Price Sheet i CSV-format:
| Metod | URI för förfrågan |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
Så här visar du uppskattade priser för förbrukningstjänster via API:et Price Sheet i JSON-format:
| Metod | URI för förfrågan |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
API:erna för prisdokument i Microsoft-kundavtal är asynkrona REST-API:er. Svaren från API:erna har ändrats jämfört med de äldre synkrona API:erna. Brödtexten i API-svaret är också ny.
Gammal brödtext i svar
Här är ett exempel på ett svar från ett synkront 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"
},
{
]
Ny brödtext i svar
API:erna har stöd för det asynkrona REST-formatet i Azure. Om du anropa API:et med GET får du följande svar:
No Response Body
HTTP Status 202 Accepted
De här rubrikerna skickas med utdataplatsen:
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}
Gör ett annat GET-anrop till platsen. Svaret på GET-anropet är detsamma tills åtgärden når en slutförd eller misslyckad status. När det är klart returnerar svaret på GET-anropsplatsen nedladdnings-URL:en som om åtgärden kördes samtidigt. Här är ett exempel:
HTTP Status 200
{
"id": "providers/Microsoft.Consumption/operationresults/{operationId}",
"name": {operationId},
"type": “Microsoft.Consumption/operationResults",
"properties" : {
"downloadUrl": {urltoblob},
"validTill": "Date"
}
}
Klienten kan också göra ett GET-anrop för Azure-AsyncOperation. Slutpunkten returnerar åtgärdens status.
I den här tabellen ser du fälten i det gamla Enterprise-API:et för att hämta prisdokument. Dessutom ser du motsvarande fält i det nya prisdokumentet för Microsoft-kundavtal:
| Gammal egenskap | Ny egenskap | Kommentar |
|---|---|---|
| billingPeriodId | Inte tillämpligt | Ej tillämpbart. Fakturan och det tillhörande prisdokumentet har ersatt begreppet billingPeriodId för Microsoft-kundavtal. |
| meterId | meterId | |
| unitOfMeasure | unitOfMeasure | De exakta strängvärdena kan variera. |
| includedQuantity | includedQuantity | Ej tillämpligt för tjänster under Microsoft-kundavtal. |
| partNumber | Inte tillämpligt | Använd i stället en kombination av productOrderName (samma som offerID) och meterID. |
| unitPrice | unitPrice | Enhetspris gäller för tjänster som förbrukas under Microsoft-kundavtal. |
| currencyCode | pricingCurrency | I Microsoft-kundavtal representeras priser med hjälp av prissättningsvalutor och faktureringsvalutor. currencyCode motsvarar pricingCurrency i Microsoft-kundavtal. |
| offerID | productOrderName | Du kan använda productOrderName i stället för OfferID, men det är inte samma sak som OfferID. productOrderName och meter fastställer dock priser i Microsoft-kundavtal som gällde meterId och OfferID i äldre registreringar. |
Åtgärder i API:et Consumption Price Sheet
För Enterprise-avtal använde du åtgärderna Get och Get By Billing Period i API:et Consumption Price Sheet för omfång per subscriptionId eller faktureringsperiod. API:et använder autentisering via Azure Resource Management.
Så här hämtar du prisdokumentinformation för ett omfång via API:et Price Sheet:
| Metod | URI för förfrågan |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
Så här hämtar du prisdokumentinformation för en faktureringsperiod via API:et Price Sheet:
| Metod | URI för förfrågan |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
I stället för API-slutpunkterna ovan använder du följande för Microsoft-kundavtal:
API:et Price Sheet för Microsoft-kundavtal (asynkront REST-API)
Det här API:et är till för Microsoft-kundavtal och innehåller extra attribut.
Prisdokument för en faktureringsprofil som omfång i ett faktureringskonto
Detta API är det befintliga API:et. Det har uppdaterats för att tillhandahålla prisdokumentet för en faktureringsprofil i ett faktureringskonto.
Prisdokument för ett faktureringskonto som omfång
Autentiseringen görs via Azure Resource Manager när du hämtar prisdokumentet för en registrering som omfång i ett faktureringskonto.
Så här hämtar du prisdokumentet för en registrering i ett faktureringskonto:
| Metod | URI för förfrågan |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
Använd informationen i följande avsnitt för ett Microsoft-kundavtal. Det innehåller fältegenskaper som används för Microsoft-kundavtal.
Prisdokument för en faktureringsprofil som omfång i ett faktureringskonto
Det uppdaterade API:et Price Sheet by billing account hämtar prisdokumentet i CSV-format. Så här hämtar du prisdokumentet för en faktureringsprofil som omfång i ett MCA:
| Metod | URI för förfrågan |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
API-svar och egenskaper är identiska för EA-registreringen som omfång. Egenskaperna motsvarar samma MCA-egenskaper.
Du hittar de äldre egenskaperna för Azure Resource Manager-API:et Price Sheet och motsvarande nya egenskaper i följande tabell.
| Gammal egenskap i Azure Resource Manager-API:et Price Sheet | Ny egenskap i MCA-API:et Price Sheet | beskrivning |
|---|---|---|
| Mätar-ID | meterId | Unik identifierare för mätaren. Samma som meterID. |
| Mätarnamn | meterName | Namnet på mätaren. Mätaren representerar den distribuerbara resursen för en Azure-tjänst. |
| Mätarkategori | service | Namnet på mätarens klassificeringskategori. Samma som tjänsten i prisdokumentet för ett Microsoft-kundavtal. De exakta strängvärdena varierar. |
| Mätarunderkategori | meterSubCategory | Namn på kategorin för mätarens underklassificering. Baserat på klassificeringen av tjänstens differentiering av högnivåfunktioner. Till exempel Basic SQL DB jämfört med Standard SQL DB. |
| Mätarregion | meterRegion | |
| Enhet | Inte tillämpligt | Kan parsas från unitOfMeasure. |
| Måttenhet | unitOfMeasure | |
| Artikelnummer | Inte tillämpligt | Använd productOrderName och MeterID i stället för artikelnummer när du ska identifiera priset för en faktureringsprofil unikt. De här fälten visas på MCA-fakturan i stället för artikelnummer. |
| Pris per enhet | unitPrice | Enhetspris för Microsoft-kundavtal. |
| Valutakod | pricingCurrency | I Microsoft-kundavtal representeras priser med hjälp av prissättningsvalutor och faktureringsvalutor. Valutakod motsvarar pricingCurrency i Microsoft-kundavtal. |
| Inkluderad mängd | includedQuantity | Gäller inte tjänster i Microsoft-kundavtal. Visa med nollvärden. |
| Erbjudande-ID | productOrderName | Använd productOrderName i stället för OfferID. productOrderName är inte detsamma som OfferID, men tillsammans med meter fastställer det priser i Microsoft-kundavtal. Relaterat till meterId och OfferID i äldre registreringar. |
Priset för Microsoft-kundavtal definieras annorlunda än för Enterprise-avtal. Priset för tjänster i Enterprise-registreringar är unikt för produkten, artikelnumret, mätaren och erbjudandet. I Microsoft-kundavtal används inga artikelnummer.
Priset för Azure-förbrukningstjänsten som ingår i ett Microsoft-kundavtal är unikt sett till productOrderName och meterID. De representerar tjänstmätaren och produktplanen.
Om du vill stämma av mellan prisdokumentet och användningen i API:et Usage Details kan du använda productOrderName och meterID.
Användare med behörighet som faktureringsprofilägare, deltagare, läsare och fakturaansvarig kan ladda ned prisdokumentet.
I prisdokumentet står priser för tjänster vars pris baseras på användning. Det är bland annat förbrukningstjänster i Azure och på Marketplace. Det senaste priset i slutet av varje tjänstperiod låses och används för all användning under tjänstperioden. För förbrukning i Azure är tjänstperioden normalt en kalendermånad.
Borttagna fält i API:et Price Sheet
De här fälten är antingen inte tillgängliga i API:et Price Sheet för Microsoft-kundavtal, eller så finns samma fält med.
| Borttaget fält | beskrivning |
|---|---|
| billingPeriodId | Inte tillämpligt. Motsvarar InvoiceId för MCA. |
| offerID | Ej tillämpbart. Motsvarar productOrderName för MCA. |
| meterCategory | Ej tillämpbart. Motsvarar Service för MCA. |
| unit | Ej tillämpbart. Kan parsas från unitOfMeasure. |
| currencyCode | Samma som pricingCurrency för MCA. |
| meterLocation | Samma som meterRegion för MCA. |
| partNumber | Inte tillämpligt eftersom artikelnummer inte står med på MCA-fakturor. I stället för artikelnummer identifierar du priser unikt med en kombination av meterId och productOrderName. |
| totalIncludedQuantity | Ej tillämpbart. |
| pretaxStandardRate | Ej tillämpbart. |
API:et Reservation Instance Charge har bytts ut
Du kan hämta faktureringstransaktioner för reservationsköp med API:et Reserved Instance Charge. Det nya API:et innehåller alla inköp, inklusive Marketplace-erbjudanden från tredje part. Alla förbruknings-API:er ersätts av interna Azure-API:er som använder Microsoft Entra-ID för autentisering och auktorisering. Du kan läsa mer om att anropa Azures REST-API:er i Komma igång med REST. API:et Reserved Instance Charge har bytts ut mot API:et Transactions.
Så här hämtar du transaktioner för reservationsköp via API:et Transactions:
| Metod | URI för förfrågan |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview |
API:erna för rekommendationer är utbytta
API:erna för rekommenderade inköp av reserverade instanser visar användning av virtuella datorer under de senaste 7, 30 eller 60 dagarna. API:erna ger även rekommendationer för reservationsköp. De omfattar:
- API:et Shared Reserved Instance Recommendation
- API:et Single Reserved Instance Recommendations
Alla förbruknings-API:er ersätts av interna Azure-API:er som använder Microsoft Entra-ID för autentisering och auktorisering. Du kan läsa mer om att anropa Azures REST-API:er i Komma igång med REST. API:erna för reservationsrekommendationer ovan ersätts av API:et Microsoft.Consumption/reservationRecommendations.
Så här hämtar du reservationsrekommendationer via API:et:
| Metod | URI för förfrågan |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01 |
API:erna för reservationsanvändning är utbytta
Du kan hämta reservationsanvändning för en registrering via API:et Reserved Instance Usage. Om det finns fler än en reserverad instans i en registrering kan du också få användningen av alla reserverade instanser via API:et.
De omfattar:
- Reserved Instance Usage Details
- Reserved Instance Usage Summary
Alla förbruknings-API:er ersätts av interna Azure-API:er som använder Microsoft Entra-ID för autentisering och auktorisering. Du kan läsa mer om att anropa Azures REST-API:er i Komma igång med REST. API:erna för reservationsrekommendationer ovan ersätts av API:erna Microsoft.Consumption/reservationDetails och Microsoft.Consumption/reservationSummaries.
Så här hämtar du reservationsinformation via API:et Reservation Details:
| Metod | URI för förfrågan |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01 |
Så här hämtar du reservationsinformation via API:et Reservation Summaries:
| Metod | URI för förfrågan |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01 |
Power BI-integrering
Du kan också rapportera kostnader med hjälp av Power BI. Cost Management-anslutningsappen för Power BI Desktop kan användas för att skapa kraftfulla, anpassade rapporter som hjälper dig att bättre förstå dina Azure-utgifter. Cost Management-anslutningsappen stöder för närvarande kunder med antingen en Microsoft-kundavtal eller en företagsavtal (EA).
Relaterat innehåll
- Läs i Cost Management-dokumentationen om du vill lära dig att övervaka och kontrollera dina Azure-utgifter. Där står även hur du kan optimera resursanvändningen med Cost Management.