Share via


EA 예약 인스턴스 권장 사항 API에서 마이그레이션

예약 인스턴스 권장 사항을 가져오기 위해 이전에 Enterprise Reporting consumer.azure.com API를 사용했던 EA 고객은 패리티 Azure Resource Manager API로 마이그레이션해야 합니다. 다음 지침은 마이그레이션 API와 새 API 간의 계약 차이점을 마이그레이션하고 설명하는 데 도움이 됩니다.

참고 항목

모든 Azure Enterprise Reporting API는 사용 중지됩니다. 가능한 한 빨리 Microsoft Cost Management API로 마이그레이션해야 합니다.

API를 호출하려면 서비스 원칙에 권한을 할당합니다.

API를 호출하기 전에 올바른 권한으로 서비스 이용자를 구성해야 합니다. 서비스 사용자를 이용해 API를 호출합니다. 자세한 내용은 Cost Management 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": "00000000-0000-0000-0000-000000000000",
        "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": "00000000-0000-0000-0000-000000000000",
      "lookBackPeriod": "Last60Days",
      "meterId": "00000000-0000-0000-0000-000000000000",
      "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/00000000-0000-0000-0000-000000000000",
      "name": "00000000-0000-0000-0000-000000000000",
      "type": "Microsoft.Consumption/reservationRecommendations",
      "location": "westus",
      "sku": "Standard_DS1_v2",
      "kind": "legacy",
      "properties": {
        "meterId": "00000000-0000-0000-0000-000000000000",
        "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"
          }
        ]
      }
    },
   ]
}