Freigeben über


Migrieren von der Gebühren-API für reservierte EA-Instanzen

EA-Kunden, die bisher die API für Unternehmensberichte von consumption.azure.com verwendet haben, um Gebühren für reservierte Instanzen abzurufen, 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 Gebühren-API für reservierte Instanzen

Verwenden Sie die folgenden Anforderungs-URIs, um die neue API für Gebühren für reservierte Instanzen aufzurufen.

Unterstützte Anforderungen

Abrufen von Reservierungsgebühren nach Datumsbereich

https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/reservationTransactions?$filter=properties/eventDate+ge+2020-05-20+AND+properties/eventDate+le+2020-05-30&api-version=2023-05-01 

Änderungen des Antworttexts

Alter Antworttext:

[
    {
        "purchasingEnrollment": "string",
        "armSkuName": "Standard_F1s",
        "term": "P1Y",
        "region": "eastus",
        "PurchasingsubscriptionGuid": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "PurchasingsubscriptionName": "string",
        "accountName": "string",
        "accountOwnerEmail": "string",
        "departmentName": "string",
        "costCenter": "",
        "currentEnrollment": "string",
        "billingFrequency": "OneTime",
        "eventDate": "string",
        "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "description": "Standard_F1s eastus 1 Year",
        "eventType": "Purchase",
        "quantity": int,
        "amount": double,
        "currency": "string",
        "reservationOrderName": "string"
    },
]

Neuer Antworttext:

{
  "id": "/billingAccounts/123456/providers/Microsoft.Consumption/reservationtransactions/201909091919",
  "name": "201909091919",
  "type": "Microsoft.Consumption/reservationTransactions",
  "tags": [],
  "properties": {
    "eventDate": "2019-09-09T19:19:04Z",
    "reservationOrderId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    "description": "Standard_DS1_v2 westus 1 Year",
    "eventType": "Refund",
    "quantity": 1,
    "amount": -21,
    "currency": "USD",
    "reservationOrderName": "Transaction-DS1_v2",
    "purchasingEnrollment": "123456",
    "armSkuName": "Standard_DS1_v2",
    "term": "P1Y",
    "region": "westus",
    "purchasingSubscriptionGuid": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "purchasingSubscriptionName": "Infrastructure Subscription",
    "accountName": "Microsoft Infrastructure",
    "accountOwnerEmail": "admin@microsoft.com",
    "departmentName": "Unassigned",
    "costCenter": "",
    "currentEnrollment": "123456",
    "billingFrequency": "recurring",
    "billingMonth": 20190901,
    "monetaryCommitment": 523123.9,
    "overage": 23234.49
}