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 標準を確認します。