API de Microsoft Intune Data Warehouse

  • Artículo

La API de Data Warehouse 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. El Data Warehouse de Intune 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 retorno y la documentación del modelo de datos de intune Data Warehouse.

Importante

Puede probar la funcionalidad más reciente de la 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 Data Warehouse de Intune a través de puntos de conexión RESTful. Para obtener acceso a los datos, el cliente debe autorizar con Microsoft Entra ID 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 Data Warehouse.

Para obtener más información, consulte Obtención de datos de la API de Data Warehouse con un cliente REST.

Nota:

Puede acceder al repositorio de Data Warehouse de GitHub Intune en Github para obtener ejemplos de código.

Interacción con la API

La API requiere autorización con Microsoft Entra ID. 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 Data Warehouse de Intune. Para obtener más información, vea Data Warehouse Modelo de datos.

Pasos siguientes

Para más información sobre cómo trabajar con Microsoft Entra ID, 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.