API Microsoft Intune Data Warehouse

  • Article

L’API Data Warehouse Intune vous permet d’accéder à vos données Intune dans un format lisible par ordinateur pour une utilisation dans votre outil d’analyse 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. Le Data Warehouse 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 Intune Data Warehouse.

Importante

Vous pouvez essayer les dernières fonctionnalités du Data Warehouse à 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 Data Warehouse Intune via des points de terminaison RESTful. Pour accéder à vos données, votre client doit autoriser avec Microsoft Entra ID à 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 Data Warehouse.

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

Remarque

Vous pouvez accéder au dépôt GitHub Intune Data Warehouse sur Github pour obtenir des exemples de code.

Interaction avec l’API

L’API nécessite une autorisation avec Microsoft Entra ID. Microsoft Entra ID 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 Data Warehouse 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 le modèle 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 Intune Data Warehouse. Pour plus d’informations, consultez modèle de données Data Warehouse.

Étapes suivantes

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

Recherchez des ressources OData sur odata.org.

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