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

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

  • Статья

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

Примечание.

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

Назначение разрешений принципу службы для вызова API

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

Вызовите API рекомендаций по зарезервированным экземплярам

Используйте следующие URI запроса для вызова нового API рекомендаций по резервированию.

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

Вызовите API с следующими разрешениями:

  • Регистрация: providers/Microsoft.Billing/billingAccounts/{billingAccountId}
  • Подписка: subscriptions/{subscriptionId}
  • Группы ресурсов: subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}

Получите рекомендации

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

https://management.azure.com/providers/Microsoft.Billing/billingAccounts/123456/providers/Microsoft.Consumption/reservationRecommendations?api-version=2023-05-01

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

В новом API рекомендации по общим и отдельным областям применения объединяются в один API.

Старый ответ для общей области:

{
        "lookBackPeriod": "Last60Days",
        "meterId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "skuName": "Standard_B1s",
        "term": "P3Y",
        "region": "eastus",
        "costWithNoRI": 39.773316464000011,
        "recommendedQuantity": 2,
        "totalCostWithRI": 22.502541385887369,
        "netSavings": 17.270775078112642,
        "firstUsageDate": "2024-02-23T00:00:00",
        "resourceType": "virtualmachines",
        "instanceFlexibilityRatio": 2.0,
        "instanceFlexibilityGroup": "BS Series",
        "normalizedSize": "Standard_B1ls",
        "recommendedQuantityNormalized": 4.0,
        "skuProperties": [
          {
            "name": "Cores",
            "value": "1"
          },
          {
            "name": "Ram",
            "value": "1"
          }
        ]
    },

Старый ответ для одной области применения:

{
      "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "lookBackPeriod": "Last60Days",
      "meterId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "skuName": "Standard_B1s",
      "term": "P3Y",
      "region": "eastus",
      "costWithNoRI": 19.892601567999996,
      "recommendedQuantity": 1,
      "totalCostWithRI": 11.252968788943683,
      "netSavings": 8.6396327790563134,
      "firstUsageDate": "2024-02-23T00:00:00",
      "resourceType": "virtualmachines",
      "instanceFlexibilityRatio": 2.0,
      "instanceFlexibilityGroup": "BS Series",
      "normalizedSize": "Standard_B1ls",
      "recommendedQuantityNormalized": 2.0,
      "skuProperties": [
        {
          "name": "Cores",
          "value": "1"
        },
        {
          "name": "Ram",
          "value": "1"
        }
      ]
}

Новый ответ:

{
  "value": [
    {
      "id": "billingAccount/123456/providers/Microsoft.Consumption/reservationRecommendations/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "name": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "type": "Microsoft.Consumption/reservationRecommendations",
      "location": "westus",
      "sku": "Standard_DS1_v2",
      "kind": "legacy",
      "properties": {
        "meterId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "term": "P1Y",
        "costWithNoReservedInstances": 12.0785105,
        "recommendedQuantity": 1,
        "totalCostWithReservedInstances": 11.4899644807748,
        "netSavings": 0.588546019225182,
        "firstUsageDate": "2019-07-07T00:00:00-07:00",
        "scope": "Shared",
        "lookBackPeriod": "Last7Days",
        "instanceFlexibilityRatio": 1,
        "instanceFlexibilityGroup": "DSv2 Series",
        "normalizedSize": "Standard_DS1_v2",
        "recommendedQuantityNormalized": 1,
        "skuProperties": [
          {
            "name": "Cores",
            "value": "1"
          },
          {
            "name": "Ram",
            "value": "1"
          }
        ]
      }
    },
   ]
}

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