Freigeben über

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

  • Artikel

EA-Kunden, die bisher die APIs für Unternehmensberichte „consumption.azure.com“ verwendet haben, um Zusammenfassungen über die Nutzung reservierter Instanzen zu erhalten, müssen zu einer gleichwertigen Azure Resource Manager-API migrieren. Die folgenden Anweisungen helfen Ihnen bei der Migration und erläutern alle Vertragsunterschiede zwischen der alten und der neuen API.

Hinweis

Alle Azure Enterprise-Berichterstellungs-APIs werden eingestellt. Sie sollten so bald wie möglich zu Microsoft Cost Management-APIs migrieren.

Zuweisen von Berechtigungen zu einem Dienstprinzipal zum Aufrufen der API

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.

Aufrufen der API für Nutzungsdetails zu reservierten Instanzen

Microsoft aktualisiert die älteren synchronen Reservierungsdetails-APIs nicht. Wir empfehlen Ihnen, im Rahmen der Migration auf das neuere asynchrone API-Aufrufmuster mit SPN-Unterstützung umzustellen. Durch asynchrone Anforderungen lassen sich große Datenmengen besser verarbeiten und Timeoutfehler verringern.

Unterstützte Anforderungen

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

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

Generieren eines Berichts nach Abrechnungskonto-ID

Beispielanforderung zum Generieren eines Berichts mit Reservierungsdetails

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:

Beispiel für eine Antwort

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 zum Abfragen des Status der Berichterstellung

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

Beispiel für Antwort auf Abfrage

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

Die folgenden Informationen stellen ein Beispiel für die Antwort der älteren synchronen API für Reservierungsdetails dar.

Alter Antworttext:

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

Neuer Antworttext:

Mit der neuen API wird eine CSV-Datei für Sie erstellt. Hier sind die Dateifelder angegeben.

Alte Eigenschaft Neue Eigenschaft Hinweise
InstanceFlexibilityGroup Die neue Eigenschaft für Instanzgrößenflexibilität.
InstanceFlexibilityRatio Die neue Eigenschaft für Instanzgrößenflexibilität.
instanceId InstanceName
Art Dies ist eine neue Eigenschaft. Der Wert lautet None, Reservation oder IncludedQuantity.
reservationId ReservationId
reservationOrderId ReservationOrderId
reservedHours ReservedHours
skuName SkuName
totalReservedQuantity TotalReservedQuantity
usageDate UsageDate
usedHours UsedHours

Zugehöriger Inhalt