Поделиться через


Миграция из API сводки баланса EA

Клиенты EA, которые ранее использовали API-интерфейсы для корпоративной отчетности consumption.azure.com для получения сводки баланса, должны перейти на использование API-интерфейса Resource Manager Azure. Следующие инструкции помогут перенести и обсудить различия между старым API и новым API.

Примечание.

Все API-интерфейсы отчетов Azure Enterprise не удаляются. Как можно скорее следует перейти в API управления затратами Майкрософт.

Назначение разрешений субъекту-службе для вызова API

Перед вызовом API необходимо настроить субъект-службу с правильным разрешением. Субъект-служба используется для вызова API. Дополнительные сведения см. в разделе "Назначение разрешений для API управления затратами".

Вызовите API сводки баланса

Следующие URI запросов используются при вызове нового API сводной информации о балансе. В качестве billingAccountId укажите номер регистрации.

Поддерживаемые запросы

Получение для регистрации

https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/balances?api-version=2023-05-01

Изменения текста ответа

Старый текст ответа:

{
  "id": "enrollments/100/billingperiods/201507/balancesummaries",
  "billingPeriodId": 201507,
  "currencyCode": "USD",
  "beginningBalance": 0,
  "endingBalance": 1.1,
  "newPurchases": 1,
  "adjustments": 1.1,
  "utilized": 1.1,
  "serviceOverage": 1,
  "chargesBilledSeparately": 1,
  "totalOverage": 1,
  "totalUsage": 1.1,
  "azureMarketplaceServiceCharges": 1,
  "newPurchasesDetails": [
    {
      "name": "",
      "value": 1
    }
  ],
  "adjustmentDetails": [
    {
      "name": "Promo Credit",
      "value": 1.1
    },
    {
      "name": "SIE Credit",
      "value": 1
    }
  ]
}

Новый текст ответа:

Эти же данные теперь доступны в поле свойств нового ответа API. Некоторые имена полей могли незначительно измениться.

{
  "id": "/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/balances/balanceId1",
  "name": "balanceId1",
  "type": "Microsoft.Consumption/balances",
  "properties": {
    "currency": "USD  ",
    "beginningBalance": 3396469.19,
    "endingBalance": 2922371.02,
    "newPurchases": 0,
    "adjustments": 0,
    "utilized": 474098.17,
    "serviceOverage": 0,
    "chargesBilledSeparately": 0,
    "totalOverage": 0,
    "totalUsage": 474098.17,
    "azureMarketplaceServiceCharges": 609.82,
    "billingFrequency": "Month",
    "priceHidden": false,
    "overageRefund": 2012.61,
    "newPurchasesDetails": [
      {
        "name": "Promo Purchase",
        "value": 1
      }
    ],
    "adjustmentDetails": [
      {
        "name": "Promo Credit",
        "value": 1.1
      },
      {
        "name": "SIE Credit",
        "value": 1
      }
    ]
  }
}