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

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

  • Статья

Клиенты EA, которые ранее использовали API Enterprise Reporting Consumer.azure.com для получения рекомендаций зарезервированного экземпляра, должны перейти на API Azure Resource Manager с контролем четности. Приведенные ниже инструкции помогут перенести и описать различия между старым API и новым 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"
          }
        ]
      }
    },
   ]
}

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