Microsoft Intune Data Warehouse-API
Mit der Intune Data Warehouse-API können Sie auf Ihre Intune-Daten in einem maschinenlesbaren Format für die Verwendung in Ihrem bevorzugten Analysetool zugreifen. 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. 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 von 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 der 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 die 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 der 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.