御成門プログラマーの技術日記

Microsoft AzureやAngularなどの技術情報を発信します

Azure Enterprise Reporting API 廃止に伴う Microsoft Cost Management API への移行方法について情報まとめ

Azure Enterprise Reporting API (EAポータルAPI) 廃止に伴う新APIへの移行に必要な情報をまとめてみました。

EAポータルのAPI「Azure Enterprise Reporting API」が2023年10月5日に廃止に → 2024年5月1日に廃止は延期されたようです。

2022年の9月頃に該当APIを使用している管理者に Microsoft から下記のような案内がメールが届いていると思います。

Migrate from Enterprise Reporting APIs to Cost Management APIs by 5 October 2023
You're receiving this email because you use Enterprise Reporting APIs.
On 5 October 2023, Azure Enterprise Reporting APIs will be retired and any remaining Enterprise Reporting APIs will stop responding to requests. You'll need to transition to using Microsoft Cost Management APIs before that date.
Cost Management APIs offer a number of improvements over Enterprise Reporting APIs, including:
• Azure Active Directory (Azure AD) authentication with user tokens or service principals.
• Enrollment scope requests and other supported Azure scopes, including Subscription, Resource Group, and Management Group.
• Purchase amortization in cost details and cost allocation. Required action
To avoid any disruption to your financial reporting, migrate all of your Enterprise Reporting APIs to Cost Management APIs by 5 October 2023.
Help and support
If you have questions, get answers from community experts in Microsoft Q&A. If you have a support plan and you need technical help, create a support request:
1. For Summary, type a description of your issue.
2. For Issue type, select Billing.
3. For Subscription, select your subscription.
4. For Problem Type, select Cost Management.
5. For Problem Subtype, select I have an issue with Cost Management APIs.

下記は日本語訳です。

2023年10月5日までにAzure Enterprise Reporting APIから Microsoft Cost Management API への移行を行ってください。
あなたが Azure Enterprise Reporting API を使用しているため、このメールを受け取っています。
2023年10月5日に、Azure Enterprise Reporting API は廃止され、残っているAzure Enterprise Reporting API はリクエストに応答しなくなります。その日までに Microsoft Cost Management API の使用に移行する必要があります。 Microsoft Cost Management API は、Azure Enterprise Reporting API に比べていくつかの改善点を提供しています。これには以下が含まれます:
• ユーザートークンまたはサービスプリンシパルを使用したAzure Active Directory(Azure AD)認証。
• 登録範囲のリクエストと他のサポートされているAzureの範囲、サブスクリプション、リソースグループ、および管理グループを含む。
• コスト詳細とコスト割り当てにおける購入の償却。
必要なアクション
あなたの財務報告への中断を避けるために、2023年10月5日までにすべてのエンタープライズレポーティングAPIをコスト管理APIに移行してください。
ヘルプとサポート 質問がある場合は、Microsoft Q&Aのコミュニティエキスパートから回答を得てください。サポートプランを持っていて技術的な助けが必要な場合は、サポートリクエストを作成してください:

1. 概要には、問題の説明を入力します。
2. 問題の種類では、請求を選択します。
3. サブスクリプションでは、あなたのサブスクリプションを選択します。
4. 問題のタイプでは、コスト管理を選択します。
5. 問題のサブタイプでは、コスト管理APIに問題があると選択します。

というわけで2023年10月5日までに「Azure Enterprise Reporting API」から「 Microsoft Cost Management API」に移行する必要があるため、私の方で集めた情報や移行方法を残しておこうと思います。

(2023年9月14日更新)Azure Enterprise Reporting API の廃止日が2024/5/1に延期になりました。

2023年9月12日ごろに該当APIを使用している管理者に対して、Azure Enterprise Reporting API の廃止が2024年5月1日に延期になることが通知されました。

On 1 May 2024, Azure Enterprise Reporting APIs will be retired and any remaining Enterprise Reporting APIs will stop responding to requests. You'll need to transition to using Microsoft Cost Management APIs before that date. The original retirement date of 5 October 2023 has been extended to give you more time to migrate.

MS公式通知メールより。以下、日本語訳。

2024年5月1日にAzure Enterprise Reporting APIは廃止され、残っているEnterprise Reporting APIはリクエストに応答しなくなります。その日までにMicrosoft Cost Management APIを使用するように移行する必要があります。2023年10月5日という当初の引退日は、移行により多くの時間を与えるために延長されました。

Azure Enterprise Reporting API から Microsoft Cost Management API に移行する方法について

移行方法については公式ページでしっかり紹介しているページがあるのでそちらを参照するのが良いと思います。
両APIの相違点、移行チェックリスト、各APIのエンドポイントの新旧対応表などが揃っているのでそちらを参照していただければと思います。
learn.microsoft.com

私の考える今回のAPI移行のキーは3点あります。

  • APIエンドポイントの変更
  • APIの認証方式の変更
  • APIの取得項目名が若干変わるのでマッピングが必要

Microsoft Cost Management API の使い方に関しては別記事でまた紹介しようと思います。