Enterprise Agreement から Microsoft 顧客契約 API に移行する

この記事では、Enterprise Agreement (EA) と Microsoft 顧客契約 (MCA) アカウントとの、データ構造、API、およびその他のシステム統合に関する違いについて説明します。 Cost Management では、両方のアカウントの種類に応じた API がサポートされています。 続行する前に、Microsoft 顧客契約の請求先アカウントの設定に関する記事を参照してください。

既存の EA アカウントを含む組織は、MCA アカウントを設定すると、このアーティクルを参照する必要があります。 以前、EA アカウントを更新するには、古い加入契約から新しい加入契約に移行するための最低限の複数の作業が必要でした。 ただし、MCA アカウントへの移行には、追加の作業量が必要です。 追加の作業量は、基になる請求先サブシステムでの変更がすべてのコスト関連 API およびサービス内容に影響するという理由で行います。

MCA API と統合

MCA API と新しい統合により、以下の操作が可能になります。

• ネイティブ Azure API から API を完全に利用できる。
• 単一の請求先アカウントで複数の請求書を構成する。
• Azure サービスの使用状況、サードパーティ製 Marketplace の使用状況、および Marketplace の購入で組み合わされた API にアクセスする。
• Cost Management を使用して複数の課金プロファイル (加入契約と同じ) にわたってコストを表示する。
• コストを表示し、コストが事前定義されたしきい値を超えたときに通知を受け、および生データをエクスポートするために新しい API にアクセスする。

移行チェックリスト

次の項目は、MCA API への移行に役立ちます。

• 新しい Microsoft 顧客契約課金アカウントについて詳しく理解します。
• 次のセクションで、使用する API を特定し、どの API が置き換えられているかを調べます。
• Azure Resource Manager REST API について詳しく理解します。を習熟する。
• まだ Azure Resource Manager API を使用していない場合は、クライアント アプリを Microsoft Entra ID に登録します。
• アクセス制御 (IAM) を使用して、Microsoft Entra アプリの登録中に作成されたアプリケーションに、課金アカウントへの読み取りアクセスを付与します。
• Microsoft Entra 認証を使用するようにプログラミング コードを更新します。
• EA API 呼び出しを置き換える MCA API 呼び出しのプログラム コードを更新します。
• 新しいエラー コードを使用するように、エラー処理を更新します。
• その他の必要なアクションについて、Power BI などの他の統合サービスを確認します。

MCA API で置き換えられた EA API

EA API は、認証と承認に API キーを使用します。 MCA API では Microsoft Entra 認証を使用します。

¹ Azure サービスとサード パーティ製 Marketplace の使用状況は、Usage Details API で利用できます。

次の API は MCA 請求先アカウントで使用できます。

² API は、Azure portal および API でのコスト管理のエクスペリエンスが動作するスコープであるオブジェクトの一覧を返します。 Azure Cost Management のスコープの詳細については、「スコープを理解して使用する」を参照してください。

任意の既存の EA API を使用する場合は、MCA 請求先アカウントをサポートするように更新する必要があります。 次の表は、その他の統合変更を示しています。

残高とクレジットを取得するための API

Get Balance Summary は、次の月次の概要を提供するために使用されました。

• Balances
• 新規購入
• Azure Marketplace のサービス料金
• 調整
• サービス超過分の請求金額

すべての Consumption API は、認証と認可に Microsoft Entra ID を使用するネイティブ Azure API に置き換えられます。 呼び出し元の Azure REST API の詳細については、REST の作業開始に関するページを参照してください。

Get Balance Summary API は、Microsoft.Billing/billingAccounts/billingProfiles/availableBalance API に置き換えられます。

Available Balance API で利用可能な残高を取得するには:

コストと使用状況を取得する API

次の API を使用して、Azure サービスの使用状況、サードパーティ製 Marketplace の使用状況、およびその他の Marketplace での購入から毎日のコストの内訳を取得します。 以下の個別の API は、Azure サービスとサードパーティ製 Marketplace の使用状況についてマージされました。 古い API は、 エクスポート または Cost Details API に置き換えられます。 適切なソリューションを選択するには、「 コストの詳細ソリューションを選択する」を参照してください。 どちらのソリューションも、同じ Cost Details ファイルを提供し、データに Marketplace の購入を含めます。これは、以前は現在までの残高の概要にのみ表示されていました。

エクスポートとCost Details API は、すべての Cost Management API と同様に複数のスコープで利用できます。 請求されたコストについては、従来より登録レベルで受信するので、課金プロファイルのスコープを使用してください。 Azure Cost Management のスコープの詳細については、「スコープを理解して使用する」を参照してください。

一部のプロパティ名は、エクスポートと Cost Details API で使用できる新しい Cost Details データセットで変更されています。 次の表では、対応するプロパティを示します。

Invoices API で置き換えられた Billing Periods API

MCA 請求先アカウントは、請求期間を使用しません。 代わりに、特定の請求期間にコストの範囲を定めるために請求書を使用します。 Billing Periods API は Invoices API に置き換えられます。 すべての Consumption API は、認証と認可に Microsoft Entra ID を使用するネイティブ Azure API に置き換えられます。 呼び出し元の Azure REST API の詳細については、REST の作業開始に関するページを参照してください。

Invoices API で請求書を取得するには:

Price Sheet API

このセクションでは、既存の Price Sheet API について説明し、Microsoft 顧客契約用の Price Sheet API への移行に関する推奨事項を示します。 また、Microsoft 顧客契約用の Price Sheet API について説明し、価格シートのフィールドについて説明します。 Enterprise Get price sheet API および Enterprise Get billing periods API は、Api は、Microsoft 顧客契約用の Price Sheet API に置き換えられます (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet)。 新しい API は、非同期の REST 形式での JSON と CSV の両方の形式をサポートしています。 すべての Consumption API は、認証と認可に Microsoft Entra ID を使用するネイティブ Azure API に置き換えられます。 呼び出し元の Azure REST API の詳細については、REST の作業開始に関するページを参照してください。

Billing Enterprise API

価格および請求期間情報を取得するために、Billing Enterprise API をエンタープライズ登録で使用していました。 認証と認可では Microsoft Entra Web トークンを使用しました。

Price Sheet および Billing Period API を使用して、指定されたエンタープライズ登録の適用可能な価格を取得するには:

Microsoft 顧客契約の Price Sheet API

Microsoft 顧客契約の Price Sheet API を使用して、すべての Azure Consumption および Marketplace 従量課金サービスの価格を表示します。 課金プロファイル用に示した料金は課金プロファイルに属しているすべてのサブスクリプションに適用されます。

Price Sheet API を使用して、CSV 形式ですべての Azure Consumption サービスの価格シート データを表示します。

Price Sheet API を使用して、JSON 形式ですべての Azure Consumption サービスの価格シート データを表示します。

API を使用すると、アカウント全体の価格シートが返されます。 ただし、PDF 形式で、簡略版の価格シートを取得することもできます。 概要には、特定の請求書について請求されている Azure Consumption および Marketplace 従量課金サービスが含まれています。 請求書は、{invoiceId} で識別され、これは請求書の概要 PDF ファイルに示された請求書番号と同じです。 次に例を示します。

CSV 形式で Price Sheet API に関する請求書情報を表示するには:

JSON 形式で Price Sheet API に関する請求書情報を表示するには:

現在開いている請求期間またはサービス期間におけるすべての Azure Consumption または Marketplace 従量課金サービスについて見積もり価格を表示することもできます。

Price Sheet API を使用して従量課金サービスの見積もり価格を CSV 形式で表示するには:

Price Sheet API を使用して従量課金サービスの見積もり価格を JSON 形式で表示するには:

Microsoft 顧客契約の Price Sheet API は、非同期 REST API です。 API の応答は、以前の同期 API から変更しました。 API 応答の本文も変更しました。

古い応答本文

同期 REST API 応答の一例を次に示します。

[
        {
            "id": "enrollments/573549891/billingperiods/2016011/products/343/pricesheets",
            "billingPeriodId": "201704",
            "meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
            "meterName": "A1 VM",
            "unitOfMeasure": "100 Hours",
            "includedQuantity": 0,
            "partNumber": "N7H-00015",
            "unitPrice": 0.00,
            "currencyCode": "USD"
        },
        {
    ]

新しい応答本文

この API は、Azure REST の非同期形式をサポートします。 GET を使用して API を呼び出すと、次の応答が表示されます。

No Response Body

HTTP Status 202 Accepted

出力の場所を示した次のヘッダーが送信されます。

Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Azure-AsyncOperation:https://managment.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==

Retry-After: 10

OData-EntityId: {operationId}

その場所に別の GET を呼び出します。 GET 呼び出しへの応答は、操作が完了または失敗の状態に到達するまでは同じです。 完了すると、GET 呼び出しの場所に対する応答は、操作が同時に実行されたかのようにダウンロード URL を返します。 次に例を示します。

HTTP Status 200

{
  "id": "providers/Microsoft.Consumption/operationresults/{operationId}",
  "name": {operationId},
  "type": “Microsoft.Consumption/operationResults",
  "properties" : {
    "downloadUrl": {urltoblob},
    "validTill": "Date"
  }
}

クライアントは、Azure-AsyncOperation に対しても GET 呼び出しを行えます。 エンドポイントは、操作の状態を返します。

次の表は、以前の Enterprise Get price sheet API のフィールドを示しています。 Microsoft の顧客契約の新しい価格シートの対応するフィールドを含んでいます。

Consumption Price Sheet API の操作

Enterprise 契約の場合、subscriptionId によるスコープや請求期間に、Consumption Price Sheet API Get および Get By Billing Period を使用しました。 API は、Azure Resource Management 認証を使用します。

Price Sheet API を使用してスコープの価格シート情報を取得するには:

Price Sheet API を使用して課金期間ごとの価格シート情報を取得するには:

上記の API エンドポイントの代わりに、Microsoft 顧客契約には次のものを使用します。

Microsoft 顧客契約の Price Sheet API (非同期 REST API)

この API は、Microsoft 顧客契約用であり、余分な属性を提供します。

請求先アカウントの課金プロファイル スコープの価格シート

この API は、既存の API です。 これは、請求先アカウントの課金プロファイルに価格シートを提供するように更新されました。

請求先アカウントごとのスコープの価格シート

Azure Resource Manager 認証は、請求先アカウントの登録スコープで価格シートを取得するときに使用されます。

請求先アカウントの登録アカウントで価格シートを取得するには:

Microsoft 顧客契約では、次のセクションの情報を使用します。 Microsoft 顧客契約に使用されるフィールド プロパティを提供します。

請求先アカウントの課金プロファイル スコープの価格シート

請求先アカウント API により更新された価格シートは、CSV 形式で価格シートを取得します。 MCA の課金プロファイル スコープで価格シートを取得するには:

EA の登録スコープでは、API の応答およびプロパティは同じです。 プロパティは、同じ MCA プロパティに対応します。

Azure Resource Manager Price Sheet API の以前のプロパティと新しい同じプロパティは、次の表に示されています。

Microsoft 顧客契約の価格は、エンタープライズ契約とは異なって定義されます。 エンタープライズ加入契約のサービスの価格は、製品、部品番号、メーター、オファーで一意です。 Microsoft 顧客契約では部品番号は使用されません。

Microsoft 顧客契約の一部である Azure 従量課金サービスの価格は、productOrderName と meterID で一意です。 これらは、サービス メーターと製品プランを表します。

価格シートと、Usage Details API での使用状況の間の調整をするために、productOrderName と meterID を使用できます。

課金プロファイル所有者、共同作成者、閲覧者、および請求書管理者の権限を持つユーザーには、価格シートをダウンロードできます。

価格シートには、価格が使用量に基づくサービスの価格が含まれています。 サービスには、Azure の消費量と Marketplace の消費量が含まれます。 各サービス期間の最後の最新価格がロックされ、単一のサービス期間における使用料に適用されます。 Azure 従量課金サービスの場合、サービス期間は通常、カレンダー月です。

廃止された Price Sheet API フィールド

次のフィールドは、Microsoft 顧客契約 Price Sheet API で使用されなくなったか、同じフィールドがあります。

置き換えられた Reservation Instance Charge API

Reserved Instance Charge API で予約購入の課金トランザクションを取得できます。 新しい API には、サード パーティ製 Marketplace のオファリングを含め、すべての購入が含まれています。 すべての Consumption API は、認証と認可に Microsoft Entra ID を使用するネイティブ Azure API に置き換えられます。 呼び出し元の Azure REST API の詳細については、REST の作業開始に関するページを参照してください。 Reserved Instance Charge API は Transactions API に置き換えられます。

Transactions API を使用して予約購入トランザクションを取得するには:

置き換えられた推奨の API

Reserved Instance Purchase Recommendations API は、過去 7 日、30 日、または 60 日にわたる仮想マシンの使用状況を示します。 API は、予約購入の推奨事項も提供します。 これには次のようなものがあります。

• Shared Reserved Instance Recommendation API
• Single Reserved Instance Recommendations API

すべての Consumption API は、認証と認可に Microsoft Entra ID を使用するネイティブ Azure API に置き換えられます。 呼び出し元の Azure REST API の詳細については、REST の作業開始に関するページを参照してください。 前述の Reservation Recommendations API は、Microsoft.Consumption/reservationRecommendations API に置き換えられました。

Reservation Recommendations API を使用して予約推奨事項を取得するには:

置き換えられた Reservation Usage API

Reserved Instance Usage API を使用して、加入契約での予約の使用状況を取得できます。 加入契約に複数の予約済みインスタンスがある場合は、この API を使用して、すべての予約済みインスタンス購入の使用状況も取得できます。

これには次のようなものがあります。

• Reserved Instance 使用量の詳細
• Reserved Instance 使用量の概要

すべての Consumption API は、認証と認可に Microsoft Entra ID を使用するネイティブ Azure API に置き換えられます。 呼び出し元の Azure REST API の詳細については、REST の作業開始に関するページを参照してください。 前述の Reservation Recommendations API は、Microsoft.Consumption/reservationDetails および Microsoft.Consumption/reservationSummaries API に置き換えられました。

Reservation Details API を使用して予約の詳細を取得するには:

Reservation Details API を使用して予約の概要を取得するには:

Power BI 統合

コストの報告には、Power BI を使用することもできます。 Power BI Desktop の Cost Management コネクタ を使用すると、Azure のコストをより深く理解するのに役立つ、カスタマイズされた高性能レポートを作成できます。 Cost Management コネクタは現在のところ、Microsoft 顧客契約またはマイクロソフト エンタープライズ契約 (EA) をお持ちのお客様がご利用いただけます。

関連するコンテンツ

• Azure の支出を監視し制御する方法については、Cost Management のドキュメントを参照してください。 または、Cost Management でリソースの使用を最適化したい場合。