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

注:

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

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

パートナー課金 API は、OData サブ名前空間 microsoft.graph.partners.billingで定義されています。

注:

通常、日次定格の使用量が Microsoft パートナー センターに表示されるか、API を介して利用可能になるまでに 24 時間かかります。

Authorization

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

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

ゼロ トラスト

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

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

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

一般的なユース ケース

パートナー課金 API には、Microsoft の直接パートナーが大量の請求済みおよび未請求の Azure 使用量、請求済みの集計使用量、請求書調整データをエクスポートできるようにするメソッドとアクションが用意されています。

請求済みの集計使用状況データ

ユース ケース API
請求済みの集計利用状況データをエクスポートするための新しいエクスポート操作を作成します billedAggregatedUsage: export
操作状態の更新のポーリング 操作を取得する

請求済みの使用状況データ

ユース ケース API
請求された使用状況データをエクスポートする新しいエクスポート操作を作成します billedUsage: export
操作状態の更新のポーリング 操作を取得する

未請求の使用状況データ

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

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

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

未請求の請求書調整データ

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

非同期データ取得

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

使用明細行品目エンドポイント

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

集計された使用状況エンドポイント

billedAggregatedUsage: export API を使用して、特定の請求書の請求済み集計使用状況データをエクスポートします。 この API は、 202 Accepted 応答コードと、長時間実行される操作への URL を含む Location ヘッダーを返します。 長時間実行される操作の状態は、マニフェスト URL で成功ステータスを受け取るまで定期的に GET 要求を行うことでチェックできます。

請求書明細項目エンドポイント

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

操作の状態エンドポイント

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