Azure Enterprise Reporting API から Microsoft Cost Management API への移行の概要

  • [アーティクル]

この記事では、 Azure Enterprise Reporting API を使用してカスタム ソリューションを構築した開発者に、重要な変更について説明します。 新しい Microsoft Cost Management API では、サービス プリンシパルの強化された機能とサポートが提供されるようになり、プロジェクトに対してより堅牢な選択肢となりました。

重要なポイント:

  • 移行の推奨 - カスタム ソリューションを Microsoft Cost Management API への移行を検討することを強くお勧めします。 これらは積極的に開発され、改善された機能を提供しています。
  • 廃止日 - Azure Enterprise Reporting API は、2024 年 5 月 1 日 に廃止されます。

この記事の内容は次のとおりです:

  • Azure Enterprise Reporting API と Cost Management API の違いの概要。
  • Cost Management API への移行時に想定される内容に関するガイダンス。
  • Cost Management API で使用できる新しい機能の分析情報。

行動喚起:

  • スムーズな移行を確保するために、廃止日の前に Cost Management API への移行の計画を開始することをお勧めします。

API の相違点

以下では、古い Azure Enterprise Reporting API と新しい Cost Management API の違いを説明します。

使用 Azure Enterprise Reporting APIs Microsoft Cost Management API
認証 Azure portal 内のプロビジョニングされた API キー ユーザー トークンまたはサービス プリンシパルを使用した Microsoft Entra 認証。 サービス プリンシパルが API キーの代わりとなります。
スコープとアクセス許可 すべての要求は加入契約スコープとなります。 加入契約全体、部署、特定のアカウントの、データが返されるかは、API キーのアクセス許可の割り当てによって決まります。 ユーザー認証はありません。 ユーザーまたはサービス プリンシパルには、加入契約、部署、アカウントのいずれかのスコープへのアクセス権が割り当てられます。
URI エンドポイント https://consumption.azure.com https://management.azure.com
開発状況 メンテナンス モードとなります。 非推奨となる予定です。 アクティブな開発
利用可能な API 現在利用可能な制限 各 EA API の代わりとなる同等の API が提供されています。 加えて、Cost Management API も利用できます。以下はその例です。
- 予算
- アラート
- エクスポート

移行チェックリスト

  • Azure Resource Manager REST API について詳しく理解します。
  • 使っている Enterprise Reporting API を明らかにし、Azure Enterprise Reporting から Microsoft Cost Management API への移行に関するページで移行する Cost Management API を確認します。
  • Cost Management API に対するサービスの承認と認証を構成します。 詳細については、ACM API へのアクセス許可の割り当てを参照してください。
  • API をテストしてからプログラミング コードを更新し、Enterprise Reporting API の呼び出しを Cost Management API の呼び出しに置き換えます。
  • 新しいエラー コードを使用するように、エラー処理を更新します。 いくつかの考慮事項を次に示します。
    • Cost Management API には、60 秒のタイムアウト期間があります。
    • Cost Management API には、レート制限が設定されています。 そのため、レートを超えた場合は、429 throttling error内になります。 短時間に多数の API 呼び出しを行うことのないようにソリューションをビルドしてください。
  • Azure Resource Manager を通じて提供されている他の Cost Management API を確認し、今後の使用に備えて評価します。 詳細については、 Azure Enterprise Reporting から Microsoft Cost Management API への移行に関するページを参照してください。

Enterprise Reporting API から新しい Cost Management API へのマッピング

以下の情報を使って、現在使っている Enterprise Reporting API と、それの代わりに使う Cost Management API を確認します。

シナリオ Enterprise Reporting API Cost Management API
EA 使用状況の詳細 API から移行する /usagedetails/download
/usagedetails/submit
/usagedetails
/usagedetailsbycustomdate		 定期的なすべてのデータ インジェスト ワークロードに 対して Microsoft.CostManagement/Exports を使用します。
小規模なオンデマンド データセットには Cost Details レポートを使用します。
EA Balance Summary API からの移行 /balancesummary Microsoft.Consumption/balances
EA Price Sheet API から移行 /pricesheet Microsoft.Consumption/pricesheets/default使用は、 交渉済みの価格用
Retail Prices API使用は、小売価格用
EA 予約インスタンス使用状況の詳細 API からの移行 /reservationdetails Microsoft.CostManagement/generateReservationDetailsReport
EA 予約インスタンス使用状況の詳細 API からの移行 /reservationsummaries Microsoft.Consumption/reservationSummaries
EA 予約インスタンスレコメンデーション API からの移行 /SharedReservationRecommendations
/SingleReservationRecommendations		 Microsoft.Consumption/reservationRecommendations
EA 予約インスタンス料金API からの移行 /reservationcharges Microsoft.Consumption/reservationTransactions

その他の Cost Management API を使用する

既存のレポート シナリオを Cost Management API に移行したら、他の多くの API も使用できます。 それらの API も Azure Resource Manager を通じて提供され、サービス プリンシパルベースの認証を使用して自動化することができます。 以下、使用できる新機能を簡単にまとめました。

  • Budgets - しきい値を設定して予防的にコストを監視し、しきい値を超えた場合には、直接の利害関係者にアラートを送信し、対応を自動化する目的で使用します。
  • Alerts - アラート情報 (予算アラート、請求書アラート、クレジット アラート、クォータ アラートなど) を確認する目的で使用します。
  • Exports - 任意の Azure ストレージ アカウントに対する課金データを定期的にエクスポートするスケジュールの設定に使用します。 Azure を積極的に活用しており、そのデータを分析して独自の内部システムで使用したいと考えるお客様に推奨されるソリューションです。

次のステップ