API d’entrepôt de données Microsoft Intune

  • Article

L’API d’entrepôt de données Intune vous permet d’accéder à vos données Intune dans un format lisible par ordinateur pour une utilisation dans votre outil analytique favori. Vous pouvez utiliser l’API pour générer des rapports qui fournissent des informations sur votre environnement mobile d’entreprise. L’API utilise le protocole OData, qui suit les modèles standard pour :

  • En-têtes de requête et de réponse
  • Codes d’état
  • Méthodes HTTP
  • Conventions d’URL
  • Types de médias
  • Formats de charge utile
  • Options de requête

OData (Open Data Protocol) est une norme OASIS (Organization for the Advancement of Structured Information Standards) qui définit les meilleures pratiques pour la création et la consommation d’API RESTful. L’entrepôt de données Intune utilise OData version 4.0.

Cette section de référence fournit une vue d’ensemble des points de terminaison, des méthodes HTTP prises en charge, des formats de charge utile de retour et de la documentation du modèle de données De l’entrepôt de données Intune.

Importante

Vous pouvez essayer les dernières fonctionnalités de l’entrepôt de données à l’aide de la version bêta. Pour utiliser la version bêta, votre URL doit contenir le paramètre api-version=betade requête . La version bêta offre des fonctionnalités avant qu’elles ne soient mises à la disposition générale en tant que service pris en charge. À mesure qu’Intune ajoute de nouvelles fonctionnalités, la version bêta peut changer le comportement et les contrats de données. Tout code personnalisé ou tout outil de création de rapports dépendant de la version bêta peut rompre avec les mises à jour en cours.

Client personnalisé OData

Vous pouvez accéder au modèle de données De l’entrepôt de données Intune via des points de terminaison RESTful. Pour accéder à vos données, votre client doit autoriser avec l’ID Microsoft Entra à l’aide d’OAuth 2.0. Vous devez d’abord configurer une application web et une application cliente dans Azure, en accordant des autorisations au client. Votre client local obtient l’autorisation et peut ensuite communiquer avec les points de terminaison de l’entrepôt de données.

Pour plus d’informations, consultez Obtenir des données à partir de l’API d’entrepôt de données avec un client REST.

Remarque

Vous pouvez accéder au référentiel GitHub Intune Data Warehouse sur Github pour obtenir des exemples de code.

Interaction avec l’API

L’API nécessite une autorisation avec l’ID Microsoft Entra. L’ID Microsoft Entra utilise OAuth 2.0. Une fois autorisé, vous pouvez obtenir des données à partir de l’API à l’aide d’un verbe HTTP GET et en contactant les collections d’entités exposées. Pour plus d’informations, consultez :

Modèle de données d’entrepôt de données Intune

OData définit un modèle de données abstrait et un protocole qui permettent à n’importe quel client d’accéder aux informations exposées par n’importe quelle source de données. La rubrique de documentation sur les modèles de données contient une explication des espaces de noms, des entités et des objets de retour dans le modèle de données De l’entrepôt de données Intune. Pour plus d’informations, consultez Data Warehouse Data Model.

Étapes suivantes

Pour en savoir plus sur l’utilisation de l’ID Microsoft Entra, consultez scénarios d’authentification pour l’ID Microsoft Entra.

Recherchez des ressources OData sur odata.org.

Passez en revue la norme OData Version 4.0 dans OData Version 4.0.