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.

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/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?api-version=2023-11-01
Retry-After: 60

Statuskod 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"
  }
}

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/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?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": "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
}

Nytt svar:

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

Relaterat innehåll

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