Microsoft Intune Data Warehouse API
Intune Data Warehouse API を使用すると、お気に入りの分析ツールで使用するために、コンピューターが読み取り可能な形式で Intune データにアクセスできます。 API を使用して、エンタープライズ モバイル環境に関する分析情報を提供するレポートを作成できます。 API は、次の標準パターンに従う OData プロトコルを使用します。
- 要求ヘッダーと応答ヘッダー
- 状態コード
- HTTP メソッド
- URL 規則
- メディアの種類
- ペイロード形式
- クエリ オプション
OData (Open Data Protocol) は、RESTful API を構築および使用するためのベスト プラクティスを定義する構造化情報標準 (OASIS) 標準の進歩のための組織です。 Intune Data Warehouse では、OData バージョン 4.0 が使用されます。
このリファレンス セクションでは、エンドポイント、サポートされている HTTP メソッド、リターン ペイロード形式、Intune Data Warehouse データ モデルのドキュメントの概要について説明します。
重要
ベータ版を使用して、Data Warehouse の最新機能を試すことができます。 ベータ版を使用するには、URL にクエリ パラメーター api-version=betaが含まれている必要があります。 ベータ版では、サポートされているサービスとして一般公開される前に機能が提供されます。 Intune で新しい機能が追加されるにつれて、ベータ版によって動作とデータ コントラクトが変更される可能性があります。 ベータ版に依存するカスタム コードまたはレポート ツールは、進行中の更新プログラムで中断する可能性があります。
OData カスタム クライアント
RESTful エンドポイントを介して Intune Data Warehouse データ モデルにアクセスできます。 データにアクセスするには、クライアントが OAuth 2.0 を使用して Microsoft Entra ID で承認する必要があります。 最初に、Azure で Web アプリとクライアント アプリを設定し、クライアントにアクセス許可を付与します。 ローカル クライアントは承認を取得し、Data Warehouse エンドポイントと通信できます。
詳細については、「 REST クライアントを使用して Data Warehouse API からデータを取得する」を参照してください。
注:
コード サンプルについては、 GitHub の GitHub Intune Data Warehouse リポジトリ にアクセスできます。
API との対話
API には、Microsoft Entra ID を使用した承認が必要です。 Microsoft Entra ID は OAuth 2.0 を使用します。 承認されたら、HTTP GET 動詞を使用して API からデータを取得し、公開されているエンティティ コレクションに接続できます。 詳細については、次を参照してください。
Intune Data Warehouse データ モデル
OData は、抽象データ モデルと、任意のデータ ソースによって公開されるクライアントアクセス情報を許可するプロトコルを定義します。 データ モデルのドキュメント トピックには、Intune Data Warehouse データ モデルの名前空間、エンティティ、および戻りオブジェクトの説明が含まれています。 詳細については、「 Data Warehouse データ モデル」を参照してください。
次の手順
Microsoft Entra ID の認証シナリオに関する記事を参照して、 Microsoft Entra ID の操作の詳細を確認してください。
odata.org で OData リソースを検索します。
OData バージョン 4.0 の OData バージョン 4.0 標準を確認します。