EA Reserved Instance Usage Summary 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 Usage Summary API を呼び出す

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

サポートされている要求

この API は、次のスコープを使用して呼び出します。

  • 加入契約: providers/Microsoft.Billing/billingAccounts/{billingAccountId}

日単位の予約概要を取得する

https://management.azure.com/{scope}/Microsoft.Consumption/reservationSummaries?grain=daily&$filter=properties/usageDate ge 2017-10-01 AND properties/usageDate le 2017-11-20&api-version=2023-05-01

月単位の予約概要を取得する

https://management.azure.com/{scope}/Microsoft.Consumption/reservationSummaries?grain=daily&$filter=properties/usageDate ge 2017-10-01 AND properties/usageDate le 2017-11-20&api-version=2023-05-01

応答本文の変更

以前の応答:

[
     {
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "skuName": "Standard_F1s",
        "reservedHours": 24,
        "usageDate": "2018-05-01T00:00:00",
        "usedHours": 23,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 95.83,
        "maxUtilizationPercentage": 100
    }
]

新しい応答:

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.Consumption/reservationSummaries/reservationSummaries_Id1",
      "name": "reservationSummaries_Id1",
      "type": "Microsoft.Consumption/reservationSummaries",
      "tags": null,
      "properties": {
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "skuName": "Standard_B1s",
        "reservedHours": 720,
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0
      }
    }
  ]
}

関連するコンテンツ