注:
この 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 並列処理を最適化するために、ファイルを分割またはパーティション分割します。