Migrieren von der EA-API für Details zur Nutzung reservierter Instanzen

EA-Kunden, die zuvor die Enterprise Reporting consumption.azure.com-API zum Abrufen reservierter Instanznutzungsdetails verwendet haben, müssen zu einer Paritäts-Azure Resource Manager-API migriert werden. Die folgenden Anweisungen helfen Ihnen beim Migrieren und Besprechen von Vertragsunterschieden zwischen der alten API und der neuen API.

Weisen Sie einem Dienstprinzipal Berechtigungen zum Aufrufen der API zu.

Bevor Sie die API aufrufen, müssen Sie einen Dienstprinzipal mit der richtigen Berechtigung konfigurieren. Sie verwenden den Dienstprinzipal, um die API aufzurufen. Weitere Informationen finden Sie unter Zuweisen von Berechtigungen zu Cost Management-APIs.

Rufen Sie die API für Reservierte Instanz-Nutzungsdetails auf

Microsoft aktualisiert nicht die älteren synchronen Reservierungsdetails-APIs. Es wird empfohlen, zum neueren spN-unterstützten asynchronen API-Aufrufmuster als Teil der Migration zu wechseln. Asynchrone Anforderungen bewältigen große Datenmengen besser und reduzieren Timeout-Fehler.

Unterstützte Anforderungen

Verwenden Sie beim Aufrufen der neuen API für asynchrone Reservierungsdetails die folgenden Anforderungs-URIs. Ihre Registrierungsnummer sollte als billingAccountId verwendet werden. Sie können den API mit dem folgenden Gültigkeitsbereich aufrufen:

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

Bericht anhand der Abrechnungskonto-ID generieren

Beispielanforderung zum Generieren eines Reservierungsdetailsberichts

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

Die POST-Anforderung gibt einen Ort zurück, an dem der Status der Berichtsgenerierung abgefragt wird, wie in der folgenden Antwort beschrieben:

Beispielantwort

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

Beispielanforderung zur Abfrage des Berichtsgenerierungsstatus

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

Beispiel-Umfrageantwort

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

Änderungen des Antwortinhalts

Die folgenden Informationen sind ein Beispiel für die Antwort der älteren synchron basierten Reservierungsdetails-API.

Alte Antwort:

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

Neue Antwort:

Die neue API erstellt eine CSV-Datei für Sie. Sehen Sie sich die folgenden Dateifelder an.

Verwandte Inhalte

• Lesen Sie den Übersichtsartikel "Migrieren von EA Reporting zu ARM-APIs ".