Microsoft Graph の従量制課金 API とサービスの概要
Microsoft Graph には、 ユーザー サブスクリプション ライセンス と従量制課金される API とサービスで追加料金なしで利用できる API が含まれています。 Microsoft Graph の従量制課金 API とサービスでは、使用量に基づいてコストが発生します。 API 呼び出しごとに、API 呼び出しで返されたオブジェクトごと、または他のメジャーを通じてコストが発生する可能性があります。
従量制課金されるかどうかにかかわらず、Microsoft Graph の API は次の 2 つの原則に従います。
- 顧客データの所有権: 顧客データは顧客に属します。 Microsoft が顧客データを分類する方法について詳しくは、こちらをご覧ください。
- 妥当なアクセス: サービスは、 定義された制限内で顧客コンテンツへのアクセスを提供します。
一部の API の測定は、プラットフォームのアクセスとコストのバランスを取ることで、現在および将来の Microsoft Graph エコシステムの正常性を確保するのに役立ちます。 ユーザー サブスクリプション ライセンスに含まれる Microsoft Graph API が従量制課金された場合、これは下位互換性のない変更であり 、Microsoft Graph のバージョン管理、サポート、および破壊的変更ポリシー が適用されます。
従量制課金 API とサービスの一覧については、「 従量制課金 API とサービス」を参照してください。
API カテゴリと測定
Microsoft Graph API は 3 つのカテゴリに分類され、API のカテゴリに基づいて測定が適用される場合があります。
標準 API
ほとんどの Microsoft Graph API は標準 API です。 これらの API は、顧客コンテンツと管理エンドポイントに対して標準操作 (作成、読み取り、更新、削除) を実行します。 これらの API の妥当なアクセス制限は、文書化された 使用しきい値に基づいて定義されます。 これにより、肯定的なカスタマー エクスペリエンスが確保され、API の効率的な使用パターンが促進されます。 定義済みの使用しきい値内の標準 API へのアクセスは、追加コストなしでユーザー ライセンスの一部として利用できます。
大容量 API
大容量 API を使用すると、顧客と開発者が大規模なデータにアクセスできるようになります。 このカテゴリには、専用の一括エクスポートまたはインポート エンドポイントと Microsoft Graph サービスが含まれます。 これらの API は従量制課金され、ユーザー サブスクリプション ライセンスを超える追加コストが発生する可能性があります。
高度な API
高度な API は、エンリッチされたデータや集計されたデータ、または Microsoft 365 から拡張される高度な機能へのアクセスを提供します。 assignSensitivityLabel API は、高度な API の例です。 これらの API は従量制課金され、ユーザー サブスクリプション ライセンスを超える追加コストが発生する可能性があります。
従量制課金 API へのアクセス
Microsoft Graph で従量制課金 API とサービスにアクセスするには、アクティブな Microsoft Azure サブスクリプションにアプリケーションを関連付ける必要があります。 アプリをサブスクリプションに関連付ける方法の詳細については、「 Microsoft Graph で従量制課金 API とサービスを有効にする」を参照してください。
従量制課金 API の使用に関する考慮事項
Microsoft Graph で従量制課金 API とサービスを使用する場合は、次の考慮事項に注意してください。
- 従量制課金 API は、他の一般的なエラーに加えて、サブスクリプションの状態に関連するエラーを返すことができます。 Microsoft Graph エラーの詳細については、「 Microsoft Graph のエラーとリソースの種類」を参照してください。
- 従量制課金 API は、API の使用状況に応じて課金されます。 特定の API に関連するコストを見積もることができるように、測定単位を必ず理解してください。
既知の制限
従量制課金 API には、次の制限事項が適用されます。
- Microsoft Graph の従量制課金 API とサービスは現在、Microsoft グローバル環境でのみ使用でき、世界中の Microsoft Graph エンドポイントを介してアクセスされる Microsoft 365 GCC デプロイを含む、国内クラウドデプロイでは使用できません。 各国のクラウドの詳細については、「 National Cloud のデプロイ」を参照してください。
- ターゲット アプリケーションは、機密クライアント アプリケーション (Web アプリケーション、Web API、デーモン/サービスなど) である必要があります。 パブリック クライアント アプリケーション (デスクトップ アプリケーションとモバイル アプリケーション) はサポートされていません。
- Azure マネージド ID は、従量制課金 API を呼び出すためにサポートされていません。 詳細については、「 マネージド ID をサポートする Azure サービス」を参照してください。