EA 予約インスタンス レコメンデーション API からの移行

  • [アーティクル]

以前に Enterprise Reporting consumption.azure.com API を使用して予約インスタンスの推奨事項を取得していた EA のお客様は、パリティ付きの Azure Resource Manager API に移行する必要があります。 次の手順は移行に役立ち、古い API と新しい API のコントラクトの違いについて説明しています。

Note

すべての Azure Enterprise Reporting API は廃止されます。 できるだけ早く Microsoft Cost Management API に移行する必要があります。

API を呼び出すアクセス許可をサービス 原則に割り当てる

API を呼び出す前に、適切なアクセス許可を持つサービス プリンシパルを構成する必要があります。 サービス プリンシパルを使用して API を呼び出します。 詳細については、「Cost Management API へのアクセス許可の割り当て」を参照してください。

Reserved Instance Recommendations API を呼び出す

新しい Reservation Recommendations API を呼び出すには、以下の要求 URI を使用します。

サポートされている要求

この 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 では、共有スコープと単一スコープの推奨情報が 1 つの 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"
          }
        ]
      }
    },
   ]
}

次のステップ