EA Reserved Instance 使用量の詳細 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 へのアクセス許可の割り当て」を参照してください。

予約インスタンス使用量の詳細 API を呼び出す

Microsoft は、以前の同期ベースの Reservation Details API を更新していません。 SPN に対応した新しい非同期 API 呼び出しパターンへの変更を、移行の一環としてお勧めします。 非同期要求の方が大量のデータを処理しやすく、タイムアウト エラーも少なくなります。

サポートされている要求

新しい Asynchronous Reservation Details API を呼び出す際は、以下の要求 URI を使用します。 billingAccountId には、実際の加入契約番号を使用する必要があります。 この API は、次のスコープを使用して呼び出すことができます:

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

課金アカウント ID でレポートを生成する

予約の詳細レポートを生成する要求のサンプル

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2023-11-01 

POST 要求は、次の応答で説明されているように、レポート生成状態をポーリングする場所を返します:

サンプル応答

状態コード 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2023-11-01
Retry-After: 60

状態コード 200

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

レポートの生成状態をポーリングする要求のサンプル

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/reservationDetailsOperationResults/{operationId}?api-version=2023-11-01 

ポーリング応答のサンプル

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

応答本文の変更

次の情報は、以前の同期ベースの Reservation Details API の応答の例です。

以前の応答:

{
    "reservationOrderId": "00000000-0000-0000-0000-000000000000",
    "reservationId": "00000000-0000-0000-0000-000000000000",
    "usageDate": "2018-02-01T00:00:00",
    "skuName": "Standard_F2s",
    "instanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resourvegroup1/providers/microsoft.compute/virtualmachines/VM1",
    "totalReservedQuantity": 18.000000000000000,
    "reservedHours": 432.000000000000000,
    "usedHours": 400.000000000000000
}

新しい応答:

新しい API では、自動的に CSV ファイルが作成されます。 次のファイル フィールドをご覧ください。

古いプロパティ	新しいプロパティ	メモ
	InstanceFlexibilityGroup	新しいインスタンス サイズの柔軟性プロパティ。
	InstanceFlexibilityRatio	新しいインスタンス サイズの柔軟性プロパティ。
instanceId	InstanceName
	種類	新しいプロパティです。 None、Reservation、IncludedQuantity のいずれかの値となります。
reservationId	ReservationId
reservationOrderId	ReservationOrderId
reservedHours	ReservedHours
skuName	SkuName
totalReservedQuantity	TotalReservedQuantity
usageDate	UsageDate
usedHours	UsedHours

次の手順

• 「EA レポートから ARM API への移行の概要」の記事を参照してください。