Microsoft Intune Data Warehouse-API

  • Artikel

Mit der Intune-Data Warehouse-API können Sie in einem maschinenlesbaren Format auf Ihre Intune-Daten zugreifen, um sie in Ihrem bevorzugten Analysetool zu verwenden. Sie können die API verwenden, um Berichte zu erstellen, die Einblicke in Ihre mobile Unternehmensumgebung bieten. Die API verwendet das OData-Protokoll, das den Standardmustern für Folgendes folgt:

  • Anforderungs- und Antwortheader
  • Statuscodes
  • HTTP-Methoden
  • URL-Konventionen
  • Medientypen
  • Nutzlastformate
  • Abfrageoptionen

OData (Open Data Protocol) ist ein OASIS-Standard (Organization for the Advancement of Structured Information Standards), der die bewährte Methode zum Erstellen und Verwenden von RESTful-APIs definiert. Die Intune-Data Warehouse verwendet OData-Version 4.0.

Dieser Referenzabschnitt bietet eine Übersicht über Endpunkte, unterstützte HTTP-Methoden, Rückgabenutzlastformate und Dokumentation zum Intune-Data Warehouse-Datenmodell.

Wichtig

Sie können die neuesten Funktionen der Data Warehouse testen, indem Sie die Betaversion verwenden. Um die Betaversion verwenden zu können, muss Ihre URL den Abfrageparameter api-version=betaenthalten. Die Betaversion bietet Features, bevor sie als unterstützter Dienst allgemein verfügbar gemacht werden. Wenn Intune neue Features hinzufügt, kann die Betaversion das Verhalten und die Datenverträge ändern. Benutzerdefinierter Code oder Berichterstellungstools, die von der Betaversion abhängig sind, können durch laufende Updates unterbrochen werden.

Benutzerdefinierter OData-Client

Sie können über RESTful-Endpunkte auf das Intune-Data Warehouse-Datenmodell zugreifen. Um Zugriff auf Ihre Daten zu erhalten, muss Ihr Kunde die Autorisierung mit Microsoft Entra ID mithilfe von OAuth 2.0 durchführen. Sie richten zunächst eine Web-App und eine Client-App in Azure ein und erteilen dem Client Berechtigungen. Ihr lokaler Client erhält eine Autorisierung und kann dann mit den Data Warehouse-Endpunkten kommunizieren.

Weitere Informationen finden Sie unter Abrufen von Daten aus der Data Warehouse-API mit einem REST-Client.

Hinweis

Sie können auf das GitHub Intune-Data Warehouse-Repository auf GitHub zugreifen, um Codebeispiele zu erhalten.

Interagieren mit der API

Die API erfordert eine Autorisierung mit Microsoft Entra ID. Microsoft Entra ID verwendet OAuth 2.0. Nach der Autorisierung können Sie Daten von der API abrufen, indem Sie ein HTTP GET-Verb verwenden und die verfügbar gemachten Entitätssammlungen kontaktieren. Weitere Informationen finden Sie unter:

Intune Data Warehouse-Datenmodell

OData definiert ein abstraktes Datenmodell und ein Protokoll, mit dem jeder Client auf Informationen zugreifen kann, die von einer beliebigen Datenquelle verfügbar gemacht werden. Das Thema zur Datenmodelldokumentation enthält eine Erläuterung der Namespaces, Entitäten und Rückgabeobjekte im Intune-Data Warehouse Datenmodell. Weitere Informationen finden Sie unter Data Warehouse Datenmodell.

Nächste Schritte

Weitere Informationen zum Arbeiten mit Microsoft Entra ID finden Sie unter Authentifizierungsszenarien für Microsoft Entra ID.

Suchen Sie OData-Ressourcen unter odata.org.

Lesen Sie den OData-Standard Version 4.0 unter OData Version 4.0.