Migrera från API för användningsinformation för ea-reserverad instans

EA-kunder som tidigare använde Enterprise Reporting consumption.azure.com-API:et för att hämta användningsinformation för reserverade instanser måste migrera till ett Azure Resource Manager-API för paritet. Följande instruktioner hjälper dig att migrera och diskutera eventuella kontraktsskillnader mellan det gamla API:et och det nya API:et.

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.

Tilldela behörigheter till ett huvudnamn för tjänsten för att anropa API:et

Innan du anropar API:et måste du konfigurera ett huvudnamn för tjänsten med rätt behörighet. Du använder tjänstens huvudnamn för att anropa API:et. Mer information finns i Tilldela behörigheter till Cost Management-API:er.

Anropa API:et för användningsinformation för reserverad instans

Microsoft uppdaterar inte de äldre synkrona api:erna för reservationsinformation. Vi rekommenderar att du flyttar till det nyare asynkrona API-anropsmönstret med SPN-stöd som en del av migreringen. Asynkrona begäranden hanterar bättre stora mängder data och minskar tidsgränsfel.

Begäranden som stöds

Använd följande begärande-URI:er när du anropar det nya API:et för asynkron reservationsinformation. Ditt registreringsnummer ska användas som billingAccountId. Du kan anropa API:et med följande omfång:

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

Generera rapport efter faktureringskonto-ID

Exempelbegäran för att skapa en rapport med reservationsinformation

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2023-11-01 

POST-begäran returnerar en plats för att avsöka rapportens genereringsstatus enligt beskrivningen i följande svar:

Exempelsvar

Statuskod 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2023-11-01
Retry-After: 60

Statuskod 200

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

Exempelbegäran för att kontrollera status för rapportgenerering

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

Exempel på avsökningssvar

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

Ändringar i svarstext

Följande information är ett exempel på svaret från det äldre synkrona api:et för reservationsinformation.

Gammalt svar:

{
    "reservationOrderId": "00000000-0000-0000-0000-000000000000",
    "reservationId": "00000000-0000-0000-0000-000000000000",
    "usageDate": "2018-02-01T00:00:00",
    "skuName": "Standard_F2s",
    "instanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resourvegroup1/providers/microsoft.compute/virtualmachines/VM1",
    "totalReservedQuantity": 18.000000000000000,
    "reservedHours": 432.000000000000000,
    "usedHours": 400.000000000000000
}

Nytt svar:

Det nya API:et skapar en CSV-fil åt dig. Se följande filfält.

Gammal egenskap	Ny egenskap	Kommentar
	InstanceFlexibilityGroup	Den nya egenskapen för flexibilitet för instansstorlek.
	InstanceFlexibilityRatio	Den nya egenskapen för flexibilitet för instansstorlek.
instanceId	InstanceName
	Variant	Det är en ny egenskap. Värdet är None, Reservation eller IncludedQuantity.
reservationId	ReservationId
reservationOrderId	ReservationOrderId
reservedHours	ReservedHours
skuName	SkuName
totalReservedQuantity	TotalReservedQuantity
usageDate	UsageDate
usedHours	UsedHours

Relaterat innehåll

• Läs översiktsartikeln Migrera från EA-rapportering till ARM-API:er.