Point de terminaison de l’API Intune Data Warehouse

Article
12/21/2023

Vous pouvez utiliser l’API Data Warehouse Intune avec un compte avec des contrôles d’accès en fonction du rôle et des informations d’identification Microsoft Entra spécifiques. 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.

ID Microsoft Entra et exigences relatives aux informations d’identification Intune

L’authentification et l’autorisation sont basées sur les informations d’identification Microsoft Entra et le contrôle d’accès en fonction du rôle (RBAC) Intune. Tous les administrateurs généraux et les administrateurs de service Intune de votre locataire ont accès à l’entrepôt de données par défaut. Utilisez des rôles Intune pour fournir l’accès à davantage 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 être l’un des éléments suivants :
- Administrateur général Microsoft Teams
- Un administrateur de service Intune
- Utilisateur disposant d’un accès en fonction du rôle à la ressource de l’entrepôt de données Intune
- Authentification sans utilisateur à l’aide de l’authentification d’application uniquement

Importante

Pour se voir attribuer un rôle Intune et accéder à la Data Warehouse Intune, 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 pour 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 Data Warehouse Intune 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 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.

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 :

DateKey seuls dans le $filter, prenant en charge les lt/le/eq/ge/gt opérateurs et joignant avec l’opérateur andlogique , où ils peuvent être mappés à une date de début et/ou de fin.
maxhistorydays est fourni en tant qu’option de requête personnalisée.

Exemples de filtres