Share via

Microsoft Graph APIを使用してパートナーの課金データをエクスポートする

  • [アーティクル]

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

注:

この API は、クラウド ソリューション プロバイダー (CSP) パートナーがテナントの請求済みおよび未請求の調整データにのみアクセスするために使用できます。 CSP プログラムの詳細については、「 Microsoft Cloud Solution Provider」を参照してください。

Microsoft パートナー センター エコシステムの一環として、クラウド ソリューション プロバイダー プログラムの Microsoft ダイレクト パートナーは、請求されたデータと未請求のデータを非同期的にAzure Blob Storageにエクスポートするように要求できます。 これにより、何時間も開いている接続を維持し、何百万ものトランザクションを繰り返しループする必要がなくなります。 非同期 API を使用すると、管理可能なチャンク内の課金データと調整データにすばやくアクセスできます。

パートナー課金 API は、OData サブネームスペース で定義されます microsoft.graph.partners.billing。

注:

通常、日単位の使用状況は、Microsoft パートナー センターに表示されるか、API を介して使用できるようになるまでに 24 時間かかります。

Authorization

調整データをエクスポートするには、呼び出し元プリンシパルがパートナー テナントにあり、適切なパートナー課金特権のアクセス許可が付与されている必要があります。 パートナー課金 API では、次のパートナーのアクセス許可がサポートされています。

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) PartnerBilling.Read.All サポートされていません。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション PartnerBilling.Read.All サポートされていません。

ゼロ トラスト

この機能は、組織が id を ゼロ トラスト アーキテクチャの 3 つの基本原則に合わせるのに役立ちます。

  • 明確に確認する
  • 最小特権を使用する
  • 侵害を想定する

ゼロ トラストとその他の方法の詳細については、organizationをガイド原則に合わせる方法については、ゼロ トラスト ガイダンス センターを参照してください。

一般的なユース ケース

パートナー課金 API には、Microsoft ダイレクト パートナーが大量の請求済みの調整データと、課金および未請求の Azure 使用状況データをエクスポートできるようにする方法とアクションが用意されています。

課金される使用状況データ

ユース ケース API
課金される使用状況データをエクスポートする新しいエクスポート操作を作成する billedUsage: export
操作状態の更新のポーリング Get 操作

未請求の使用状況データ

ユース ケース API
新しいエクスポート操作を作成して、未請求の使用状況データをエクスポートする unbilledUsage: export
操作状態の更新のポーリング Get 操作

請求済みの請求書調整データ

ユース ケース API
請求書調整データをエクスポートする新しいエクスポート操作を作成する billedReconciliation: export
操作状態の更新のポーリング Get 操作

非同期データ取得

使用状況または調整データのダウンロードは、次の操作で構成される実行時間の長い操作です。

使用状況の行項目エンドポイント

billedUsage: export または unbilledUsage: export API を使用して、課金済みまたは未請求の消費明細にアクセスします。 API は、 202 Accepted 実行時間の長い操作の URL を含む応答コードと Location ヘッダーを返します。 マニフェスト URL で成功状態を受け取るまで、定期的に GET 要求を行うことで、実行時間の長い操作の状態をチェックできます。

非使用の行項目エンドポイント

課金済みのReconciliation: export API を使用して、請求された請求書調整明細にアクセスします。 API は、 202 Accepted 実行時間の長い操作の URL を含む応答コードと Location ヘッダーを返します。 マニフェスト URL で成功状態を受け取るまで、定期的に GET 要求を行うことで、実行時間の長い操作の状態をチェックできます。

操作状態エンドポイント

成功状態になるまで、 Get 操作 API を定期的にポーリングし続けます。 要求されたデータが使用できない場合、API 応答には、別の要求を Retry-After 送信する前に待機する必要がある時間を示すヘッダーが含まれます。 操作が正常に完了すると、応答によって、生成されたファイルの詳細を 含むマニフェスト も提供されます。 マニフェストには、実際の課金データをダウンロードできるストレージ フォルダーが用意されています。 応答は、スループットと I/O 並列処理を最適化するためにファイルを分割またはパーティション分割します。