Punto de conexión de API de Data Warehouse de Microsoft Intune
Puede usar la API de Intune Data Warehouse con una cuenta con controles de acceso basados en rol específicos y credenciales de Microsoft Entra. A continuación, autorizará el cliente REST con Microsoft Entra ID mediante OAuth 2.0. Y, por último, formará una dirección URL significativa para llamar a un recurso de almacenamiento de datos.
requisitos de credenciales Microsoft Entra ID y Intune
La autenticación y autorización se basan en credenciales de Microsoft Entra y Intune control de acceso basado en rol (RBAC). De forma predeterminada, todos los administradores globales y Intune administradores de servicios del inquilino tienen acceso al almacenamiento de datos. Use Intune roles para proporcionar acceso a más usuarios, ya que les proporciona acceso al recurso de almacenamiento de datos Intune.
Los requisitos para acceder a Data Warehouse de Intune (incluida la API) son:
- El usuario debe tener como mínimo uno de los siguientes roles:
- Administrador del servicio de Intune
- Usuario con acceso basado en rol a Intune recurso de almacenamiento de datos
- Autenticación sin usuario mediante la autenticación de solo aplicación
Importante
Para tener asignado un rol de Intune y acceder a la Intune Data Warehouse, el usuario debe tener una licencia de Intune. Para obtener más información, consulte Control de acceso basado en rol (RBAC) con licencias de Microsoft Intune y Microsoft Intune.
Autorización
Microsoft Entra ID usa OAuth 2.0 para permitirle autorizar el acceso a aplicaciones web y API web en el inquilino de Microsoft Entra. Esta guía es independiente del lenguaje y describe cómo enviar y recibir mensajes HTTP sin usar ninguna biblioteca de código abierto. El flujo de código de autorización de OAuth 2.0 se describe en la sección 4.1 de la especificación de OAuth 2.0.
Para obtener más información, consulte Autorización del acceso a aplicaciones web mediante OAuth 2.0 y Microsoft Entra ID.
Estructura de dirección URL de API
Los puntos de conexión Data Warehouse API leen las entidades de cada conjunto. La API admite un verbo HTTP GET y un subconjunto de opciones de consulta.
La dirección URL de Intune usa el formato siguiente:
https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}
Nota:
En la dirección URL anterior, reemplace {location}, {entity-collection}y {api-version} en función de los detalles proporcionados en la tabla siguiente.
La dirección URL contiene los siguientes elementos:
| Elemento | Ejemplo | Descripción |
|---|---|---|
| ubicación | msua06 | Para encontrar la dirección URL base, consulte la hoja api de Data Warehouse en el centro de administración de Microsoft Intune. |
| entity-collection | devicePropertyHistories | Nombre de la colección de entidades OData. Para obtener más información sobre las colecciones y entidades en el modelo de datos, vea Modelo de datos. |
| api-version | beta | La versión es la versión de la API a la que se va a acceder. Para obtener más información, vea Versión. |
| maxhistorydays | 7 | (Opcional) Número máximo de días de historial que se van a recuperar. Este parámetro se puede proporcionar a cualquier colección, pero solo surtirá efecto para las colecciones que se incluyen dateKey como parte de su propiedad key. Consulte Filtros de intervalo datekey para obtener más información. |
Información de versión de API
Ahora puede usar la versión v1.0 del Intune Data Warehouse estableciendo el parámetro api-version=v1.0de consulta . Novedades a las colecciones de los Data Warehouse son aditivos por naturaleza y no interrumpen los escenarios existentes.
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.
Opciones de consulta de OData
La versión actual admite los siguientes parámetros de consulta de OData: $filter, $select$skip, y $top. En $filter, solo DateKey se puede admitir o RowLastModifiedDateTimeUTC cuando las columnas son aplicables, y otras propiedades desencadenarían una solicitud incorrecta.
Filtros de intervalo datekey
DateKey Los filtros de intervalo se pueden usar para limitar la cantidad de datos que se van a descargar para algunas de las colecciones con dateKey como propiedad de clave. El DateKey filtro se puede usar para optimizar el rendimiento del servicio proporcionando el siguiente $filter parámetro de consulta:
-
DateKeysolo en ,$filterque admite loslt/le/eq/ge/gtoperadores y se une con el operadorandlógico , donde se pueden asignar a una fecha de inicio o una fecha de finalización. -
maxhistorydaysse proporciona como opción de consulta personalizada.
Ejemplos de filtro
Nota:
Los ejemplos de filtro suponen que hoy es 2/21/2018.
| Filtro | Optimización del rendimiento | Descripción |
|---|---|---|
maxhistorydays=7 |
Full | Devolver datos con DateKey entre 20180214 y 20180221. |
$filter=DateKey eq 20180214 |
Full | Devolver datos con DateKey igual a 20180214. |
$filter=DateKey ge 20180214 and DateKey lt 20180221 |
Full | Devolver datos con DateKey entre 20180214 y 20180220. |
maxhistorydays=7&$filter=DateKey eq 20180214 |
Full | Devolver datos con DateKey igual a 20180214.
maxhistorydays se omite. |
$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z |
Full | Devolver datos con RowLastModifiedDateTimeUTC es mayor o igual que 2018-02-21T23:18:51.3277273Z |