Microsoft Intune API de almacenamiento de datos
La API de almacenamiento de datos de Intune te permite acceder a los datos de Intune en un formato legible por máquina para usarlos en la herramienta de análisis favorita. Puede usar la API para crear informes que proporcionen información sobre el entorno móvil de la empresa. 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 dirección URL
- Tipos de medios
- Formatos de carga útil
- Opciones de consulta
El OData (Open Data Protocol) es un estándar de organización para el avance de estándares de información estructurados (OASIS) que define los procedimientos recomendados para crear y consumir API RESTful. El Almacén de datos de Intune usa OData versión 4.0.
En esta sección de referencia se proporciona información general sobre los puntos de conexión, los métodos HTTP compatibles, los formatos de carga devueltos y la documentación del modelo de datos de almacenamiento de datos de Intune.
Importante
Puedes probar la funcionalidad más reciente del almacén de datos mediante la versión beta. Para usar la versión beta, la dirección URL debe contener el parámetro de consulta api-version=beta . La versión beta ofrece características antes de que estén disponibles generalmente 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 dependientes de la versión beta pueden interrumpirse con actualizaciones en curso.
Cliente personalizado de OData
Puede obtener acceso al modelo de datos de Almacenamiento de datos de Intune a través de puntos de conexión RESTful. Para obtener acceso a los datos, el cliente debe autorizar con Azure Active Directory (Azure AD) mediante OAuth 2.0. Primero configure una aplicación web y una aplicación cliente en Azure, 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, vea Get data from the Data Warehouse API with a REST client
Nota
Puede obtener acceso al repositorio GitHub almacén de datos de Intune en Github para obtener ejemplos de código.
Interactuar con la API
La API requiere autorización con Azure AD. Azure AD 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, vea:
Modelo de datos de almacenamiento de datos de Intune
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 almacenamiento de datos de Intune. Para obtener más información, vea Data Warehouse Data Model.
Pasos siguientes
Obtenga más información sobre cómo trabajar con Azure AD mediante la lectura de escenarios de autenticación para Azure AD.
Busque recursos de OData en odata.org.
Revise el estándar OData Versión 4.0 en [OData Versión 4.0] (https://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part1-protocol.html)