Point de terminaison de l’API Intune Data Warehouse
Vous pouvez utiliser l’API Intune Data Warehouse avec un compte avec des contrôles d’accès en fonction du rôle spécifiques et des informations d’identification Microsoft Entra. Vous autoriserez ensuite votre client REST avec Microsoft Entra ID à l’aide d’OAuth 2.0. Enfin, vous allez former une URL explicite pour appeler une ressource d’entrepôt de données.
Microsoft Entra ID et Intune informations d’identification requises
L’authentification et l’autorisation sont basées sur les informations d’identification Microsoft Entra et Intune contrôle d’accès en fonction du rôle (RBAC). Tous les administrateurs généraux et administrateurs de service Intune de votre locataire ont accès à l’entrepôt de données par défaut. Utilisez Intune rôles pour fournir l’accès à plus d’utilisateurs en leur donnant accès à la ressource d’entrepôt de données Intune.
Les conditions requises pour accéder aux Intune Data Warehouse (y compris l’API) sont les suivantes :
- L’utilisateur doit avoir au moins l’un des rôles suivants :
- Un administrateur de service Intune
- Utilisateur disposant d’un accès en fonction du rôle à Intune ressource d’entrepôt de données
- Authentification sans utilisateur à l’aide de l’authentification d’application uniquement
Importante
Pour se voir attribuer un rôle Intune et accéder au Intune Data Warehouse, l’utilisateur doit disposer d’une licence Intune. Pour plus d’informations, consultez Contrôle d’accès en fonction du rôle (RBAC) avec Microsoft Intune et Microsoft Intune licences.
Autorisation
Microsoft Entra ID utilise OAuth 2.0 pour vous permettre d’autoriser l’accès aux applications web et aux API web dans votre locataire Microsoft Entra. Ce guide est indépendant du langage et explique comment envoyer et recevoir des messages HTTP sans utiliser de bibliothèque open source. Le flux de code d’autorisation OAuth 2.0 est décrit dans la section 4.1 de la spécification OAuth 2.0.
Pour plus d’informations, consultez Autoriser l’accès aux applications web à l’aide d’OAuth 2.0 et Microsoft Entra ID.
Structure d’URL d’API
Les points de terminaison d’API Data Warehouse lisent les entités pour chaque ensemble. L’API prend en charge un verbe HTTP GET et un sous-ensemble d’options de requête.
L’URL de Intune utilise le format suivant :
https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}
Remarque
Dans l’URL ci-dessus, remplacez {location}, {entity-collection}et {api-version} en fonction des détails fournis dans le tableau ci-dessous.
L’URL contient les éléments suivants :
| Élément | Exemple | Description |
|---|---|---|
| emplacement | msua06 | L’URL de base est disponible en consultant le panneau API Data Warehouse dans le centre d’administration Microsoft Intune. |
| entity-collection | devicePropertyHistories | Nom de la collection d’entités OData. Pour plus d’informations sur les collections et les entités dans le modèle de données, consultez Modèle de données. |
| api-version | bêta | Version est la version de l’API à laquelle accéder. Pour plus d’informations, consultez Version. |
| maxhistorydays | 7 | (Facultatif) Nombre maximal de jours d’historique à récupérer. Ce paramètre peut être fourni à n’importe quelle collection, mais prend effet uniquement pour les collections qui incluent dateKey dans le cadre de leur propriété de clé. Pour plus d’informations, consultez Filtres de plage DateKey . |
Informations sur la version de l’API
Vous pouvez maintenant utiliser la version v1.0 du Intune Data Warehouse en définissant le paramètre api-version=v1.0de requête . Mises à jour aux collections dans le Data Warehouse sont de nature additive et ne cassent pas les scénarios existants.
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 que 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.
Options de requête OData
La version actuelle prend en charge les paramètres de requête OData suivants : $filter, $select$skip, et $top. Dans $filter, ou RowLastModifiedDateTimeUTC peut être pris en charge uniquement DateKey lorsque les colonnes sont applicables, et que d’autres propriétés déclenchent une requête incorrecte.
Filtres de plage DateKey
DateKey Les filtres de plage peuvent être utilisés pour limiter la quantité de données à télécharger pour certaines collections avec dateKey comme propriété clé. Le DateKey filtre peut être utilisé pour optimiser les performances du service en fournissant le paramètre de requête suivant $filter :
-
DateKeyseuls dans le$filter, prenant en charge leslt/le/eq/ge/gtopérateurs et joignant avec l’opérateurandlogique , où ils peuvent être mappés à une date de début et/ou de fin. -
maxhistorydaysest fourni en tant qu’option de requête personnalisée.
Exemples de filtres
Remarque
Les exemples de filtres supposent qu’aujourd’hui est le 21/02/2018.
| Filtre | Optimisation des performances | Description |
|---|---|---|
maxhistorydays=7 |
Complet | Retourne des données avec DateKey entre 20180214 et 20180221. |
$filter=DateKey eq 20180214 |
Complet | Retourne des données égales DateKey à 20180214. |
$filter=DateKey ge 20180214 and DateKey lt 20180221 |
Complet | Retourner des données avec DateKey entre 20180214 et 20180220. |
maxhistorydays=7&$filter=DateKey eq 20180214 |
Complet | Retourne des données égales DateKey à 20180214.
maxhistorydays est ignoré. |
$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z |
Complet | Retourner des données avec RowLastModifiedDateTimeUTC est supérieur ou égal à 2018-02-21T23:18:51.3277273Z |