Share via

Migreren van DE API voor EA-prijzenoverzichten

  • Artikel

EA-klanten die voorheen de Enterprise Reporting consumption.azure.com-API gebruikten om hun prijzenoverzicht op te halen, moeten worden gemigreerd naar een vervangende Azure Resource Manager-API. De volgende instructies helpen u bij het migreren en ze beschrijven ook eventuele contractverschillen tussen de oude API en de nieuwe API.

Notitie

Alle Azure Enterprise Reporting-API's worden buiten gebruik gesteld. U moet zo snel mogelijk migreren naar Microsoft Cost Management-API's .

Machtigingen toewijzen aan een service-principal om de API aan te roepen

Voordat u de API aanroept, moet u een SERVICE-principal (SPN) configureren met de juiste machtiging. U gebruikt de service-principal om de API aan te roepen. Zie Machtigingen toewijzen aan Cost Management-API's voor meer informatie.

De API voor prijzenoverzichten aanroepen

De API voor prijzenoverzichten genereert het prijzenoverzicht asynchroon en produceert een bestand dat u downloadt.

Gebruik de volgende aanvraag-URI's bij het aanroepen van de nieuwe API voor prijzenoverzichten:

Ondersteunde aanvragen

U kunt de API aanroepen met behulp van het volgende bereik:

Inschrijving: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Downloaden per factureringsrekening voor de opgegeven factureringsperiode

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

De POST-aanvraag retourneert een locatie om de status van het genereren van rapporten te peilen, zoals wordt beschreven in het volgende antwoord:

Voorbeeldrespons

Statuscode: 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01
Retry-After: 60

Statuscode: 200

{
  "status": "Completed",
  "properties": {
    "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

Voorbeeldaanvraag voor het opvragen van de generatiestatus van het rapport

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01

Wijzigingen in antwoordtekst

[
        {
              "id": "enrollments/57354989/billingperiods/201601/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"
        },
        {
              "id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
              "billingPeriodId": "201404",
            "meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
              "meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
              "unitOfMeasure": "100 GB",
              "includedQuantity": 0,
              "partNumber": "N9H-00402",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        ...
]

Nieuwe antwoordwijzigingen

De eigenschappen van het prijzenoverzicht zijn als volgt:

Naam Type Beschrijving
basePrice tekenreeks De eenheidsprijs op het moment dat de klant zich aanmeldt of de eenheidsprijs op het moment van de ga-start van de servicemeter als deze zich na aanmelding bevindt.

Dit is van toepassing op Enterprise Overeenkomst gebruikers
currencyCode tekenreeks Valuta waarin de Enterprise Overeenkomst is ondertekend
effectiveEndDate tekenreeks Effectieve einddatum van de factureringsperiode voor prijzenoverzichten
effectiveStartDate tekenreeks Effectieve begindatum van de factureringsperiode van het prijzenoverzicht
enrollmentNumber tekenreeks Unieke id voor de EA-factureringsrekening.
includedQuantity tekenreeks Hoeveelheden van een specifieke service waartoe een EA-klant recht heeft zonder incrementele kosten.
marketPrice tekenreeks De huidige catalogusprijs voor een bepaald product of een bepaalde service. Deze prijs is zonder onderhandelingen en is gebaseerd op uw Type Microsoft-overeenkomst.

Voor PriceType Consumption wordt de marktprijs weergegeven als de prijs voor betalen per gebruik.

Voor PriceType Savings Plan weerspiegelt de marktprijs het voordeel van het spaarplan boven op de prijs voor betalen per gebruik voor de bijbehorende toezeggingstermijn.

Voor PriceType ReservedInstance weerspiegelt de marktprijs de totale prijs van de toezegging van één of drie jaar.

Opmerking: Voor EA-klanten zonder onderhandelingen kan de marktprijs worden afgerond op een andere decimale precisie dan eenheidsprijs.
meterCategory tekenreeks Naam van de classificatiecategorie voor de meter. Bijvoorbeeld Cloudservices en Netwerken enz.
meterId tekenreeks Unieke id van de meter
meterName tekenreeks Naam van de meter. De meter vertegenwoordigt de implementeerbare resource van een Azure-service.
meterRegion tekenreeks Naam van de Azure-regio waar de meter voor de service beschikbaar is.
meterSubCategory tekenreeks De naam van de subclassificatiecategorie voor de meter.
meterType tekenreeks Naam van het metertype
partNumber tekenreeks Onderdeelnummer dat is gekoppeld aan de meter
priceType tekenreeks Prijstype voor een product. Een Azure-resource met een betalen per gebruik-tarief met priceType als Verbruik. Andere prijstypen zijn ReservedInstance en Spaarplan.
product tekenreeks Naam van het product met de kosten.
productId tekenreeks Unieke identificatie voor het product waarvan de meter wordt verbruikt.
serviceFamily Nummer Type Azure-service. Bijvoorbeeld Compute, Analytics en Beveiliging.
skuId tekenreeks Unieke id van de SKU
Termijn tekenreeks Termijnlengte voor Azure Savings Plan of Reserveringstermijn: één jaar of drie jaar (P1Y of P3Y)
unitOfMeasure tekenreeks Hoe het gebruik wordt gemeten voor de service
unitPrice tekenreeks De prijs per eenheid op het moment van facturering voor een bepaald product of een bepaalde dienst, inclusief eventuele overeengekomen kortingen boven op de marktprijs.

Voor PriceType ReservedInstance weerspiegelt de eenheidsprijs de totale kosten van de toezegging van één of drie jaar, inclusief kortingen.

Opmerking: de eenheidsprijs is niet hetzelfde als de effectieve prijs in gebruiksgegevensdownloads wanneer services differentiële prijzen hebben in verschillende lagen.

Als services een prijs met meerdere lagen zijn, is de effectieve prijs een gemengde prijs in de verschillende lagen en wordt er geen prijs per categorie weergegeven. De gemengde prijs of werkelijke prijs is de nettoprijs voor de verbruikte hoeveelheid in de verschillende categorieën (waarbij elke categorie een specifieke eenheidsprijs heeft).

Gerelateerde inhoud