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

Миграция из API сведений об использовании зарезервированных экземпляров EA

  • Статья

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

Примечание.

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

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

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

Вызов API получения сведений об использовании зарезервированных экземпляров

Корпорация Майкрософт не обновляет старые синхронные API сведений о резервировании. Мы рекомендуем в процессе миграции перейти к более новому шаблону асинхронного вызова API, поддерживаемому SPN. Асинхронные запросы лучше справляются с большими объемами данных и реже приводят к ошибкам времени ожидания.

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

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

Регистрация: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

Создание отчета по идентификатору учетной записи выставления счетов

Пример запроса для создания отчета о резервировании

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

Запрос POST возвращает расположение для опроса состояния создания отчета, как описано в следующем ответе:

Пример ответа

Код состояния 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

Код состояния 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"
  }
}

Пример запроса для опроса состояния создания отчета

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

Пример ответа на такой опрос

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

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

Ниже приведен пример ответа старого API сведений о резервировании на основе синхронизации.

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

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

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

Новый API создает для вас CSV-файл, который включает следующие поля.

Старое свойство Новое свойство Примечания.
InstanceFlexibilityGroup Новое свойство гибкости размера экземпляра.
InstanceFlexibilityRatio Новое свойство гибкости размера экземпляра.
instanceId InstanceName
Вид Новое свойство. Оно принимает значения None, Reservation или IncludedQuantity.
reservationId Идентификатор резервирования
reservationOrderId ReservationOrderId
reservedHours ReservedHours
skuName SkuName
totalReservedQuantity TotalReservedQuantity
usageDate UsageDate
usedHours UsedHours

Связанный контент