Delen via

Migreren vanuit de API voor gebruiksgegevens van gereserveerde EA-instanties

  • Artikel

EA-klanten die voorheen de Enterprise Reporting consumption.azure.com-API gebruikten om gebruiksgegevens van gereserveerde instanties te verkrijgen, moeten worden gemigreerd naar een Azure Resource Manager-API voor pariteit. De volgende instructies helpen u bij het migreren en bespreken van 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 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 gebruiksgegevens van gereserveerde instanties aanroepen

Microsoft werkt de oudere synchroon gebaseerde API's voor reserveringsgegevens niet bij. We raden u aan om, als onderdeel van de migratie, over te stappen op het nieuwere met SPN ondersteunde asynchrone API-aanroeppatroon. Asynchrone aanvragen kunnen grote hoeveelheden gegevens beter verwerken en time-outfouten verminderen.

Ondersteunde aanvragen

Gebruik de volgende aanvraag-URI's wanneer u de nieuwe API voor Asynchrone reserveringsdetails aanroept. Uw inschrijvingsnummer moet worden gebruikt als billingAccountId. U kunt de API aanroepen met het volgende bereik:

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

Rapport genereren op factureringsrekening-id

Voorbeeldaanvraag voor het genereren van een rapport met reserveringsdetails

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&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/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?api-version=2023-11-01
Retry-After: 60

Statuscode 200

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Voorbeeldaanvraag voor het opvragen van de generatiestatus van het rapport

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/reservationDetailsOperationResults/{operationId}?api-version=2023-11-01

Voorbeeldantwoord voor poll

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

Wijzigingen in antwoordtekst

De volgende informatie is een voorbeeld van het antwoord van de oudere synchrone API voor reserveringsgegevens.

Oud antwoord:

{
    "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "reservationId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
    "usageDate": "2018-02-01T00:00:00",
    "skuName": "Standard_F2s",
    "instanceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/resourcegroup1/providers/microsoft.compute/virtualmachines/VM1",
    "totalReservedQuantity": 18.000000000000000,
    "reservedHours": 432.000000000000000,
    "usedHours": 400.000000000000000
}

Nieuw antwoord:

Met de nieuwe API wordt een CSV-bestand gemaakt. Bekijk de volgende velden in het bestand.

Oude eigenschap Nieuwe eigenschap Opmerkingen
InstanceFlexibilityGroup De flexibiliteitseigenschap voor de nieuwe instantiegrootte.
InstanceFlexibilityRatio De flexibiliteitseigenschap voor de nieuwe instantiegrootte.
instanceId InstanceName
Soort Het is een nieuwe eigenschap. Waarde is None, Reservation of IncludedQuantity.
reservationId ReservationId
reservationOrderId ReservationOrderId
reservedHours ReservedHours
skuName SkuName
totalReservedQuantity TotalReservedQuantity
usageDate UsageDate
usedHours UsedHours

Gerelateerde inhoud