API de almacenamiento de datos de Microsoft Intune
La API de Almacenamiento de datos de Intune le permite acceder a los datos de Intune en un formato legible para su uso en su herramienta de análisis favorita. Puede usar la API para crear informes que proporcionen información sobre el entorno móvil empresarial. La API usa el protocolo OData, que sigue los patrones estándar para:
- Encabezados de solicitud y respuesta
- Códigos de estado
- Métodos HTTP
- Convenciones de direcciones URL
- Tipos de medios
- Formatos de carga
- Opciones de consulta
OData (Open Data Protocol) es un estándar de organización para el avance de los estándares de información estructurados (OASIS) que define el procedimiento recomendado para crear y consumir API RESTful. Intune Data Warehouse usa la versión 4.0 de OData.
En esta sección de referencia se proporciona información general sobre los puntos de conexión, los métodos HTTP admitidos, los formatos de carga de devolución y la documentación del modelo de datos de Intune Data Warehouse.
Importante
Puede probar la funcionalidad más reciente de Data Warehouse mediante la versión beta. Para usar la versión beta, la dirección URL debe contener el parámetro api-version=betade consulta . La versión beta ofrece características antes de que estén disponibles con carácter general como un servicio compatible. A medida que Intune agrega nuevas características, la versión beta puede cambiar el comportamiento y los contratos de datos. Cualquier código personalizado o herramientas de informes que dependan de la versión beta pueden interrumpirse con las actualizaciones en curso.
Cliente personalizado de OData
Puede acceder al modelo de datos de Intune Data Warehouse a través de puntos de conexión RESTful. Para obtener acceso a los datos, el cliente debe autorizar con el identificador de Microsoft Entra mediante OAuth 2.0. Primero configure una aplicación web y una aplicación cliente en Azure y conceda permisos al cliente. El cliente local obtiene autorización y, a continuación, puede comunicarse con los puntos de conexión de Almacenamiento de datos.
Para obtener más información, consulte Obtención de datos de la API de almacenamiento de datos con un cliente REST.
Nota:
Puede acceder al repositorio de Almacenamiento de datos de GitHub Intune en Github para obtener ejemplos de código.
Interacción con la API
La API requiere autorización con el identificador de Microsoft Entra. Microsoft Entra ID usa OAuth 2.0. Una vez autorizado, puede obtener datos de la API mediante un verbo HTTP GET y ponerse en contacto con las colecciones de entidades expuestas. Para obtener más información, consulte:
Modelo de datos de Intune Data Warehouse
OData define un modelo de datos abstracto y un protocolo que permite a cualquier cliente acceder a la información expuesta por cualquier origen de datos. El tema de documentación del modelo de datos contiene una explicación de los espacios de nombres, las entidades y los objetos devueltos en el modelo de datos de Intune Data Warehouse. Para obtener más información, vea Modelo de datos de almacenamiento de datos.
Siguientes pasos
Para obtener más información sobre cómo trabajar con el identificador de Microsoft Entra, consulte Escenarios de autenticación para microsoft entra ID.
Busque recursos de OData en odata.org.
Revise el estándar de la versión 4.0 de OData en la versión 4.0 de OData.