Ponto de extremidade da API do Intune Data Warehouse

Você pode usar a API do Intune Data Warehouse com uma conta com controles de acesso e credenciais de Microsoft Entra baseados em função específicos. Em seguida, você autorizará seu cliente REST com o Microsoft Entra ID usando o OAuth 2.0. E, finalmente, você formará uma URL significativa para chamar um recurso de data warehouse.

Requisitos de credencial do Microsoft Entra ID e do Intune

A autenticação e a autorização são baseadas nas credenciais do Microsoft Entra e no RBAC (controle de acesso baseado em função) do Intune. Todos os administradores do Intune para seu locatário têm acesso ao Data warehouse por padrão. Use funções do Intune para fornecer acesso a mais usuários, dando-lhes acesso ao recurso do data warehouse do Intune.

Os requisitos para acessar o Intune Data Warehouse (incluindo a API) são:

• O usuário deve ter no mínimo uma das seguintes funções:
  • Um administrador de serviços do Intune
  • Usuário com acesso baseado em função ao recurso do data warehouse do Intune
  • Autenticação sem usuário usando autenticação somente de aplicativo

Authorization

O Microsoft Entra ID usa o OAuth 2.0 para permitir que você autorize o acesso a aplicativos Web e APIs Web em seu locatário do Microsoft Entra. Este guia é independente de linguagem e descreve como enviar e receber mensagens HTTP sem usar nenhuma biblioteca de código aberto. O fluxo de código de autorização do OAuth 2.0 é descrito na seção 4.1 da especificação do OAuth 2.0.

Para obter mais informações, consulte Autorizar o acesso a aplicativos Web usando o OAuth 2.0 e o Microsoft Entra ID.

Estrutura de URL da API

Os pontos de extremidade da API do Data Warehouse leem as entidades de cada conjunto. A API dá suporte a um verbo HTTP GET e a um subconjunto de opções de consulta.

A URL do Intune usa o seguinte formato:https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

A URL contém os seguintes elementos:

Informações de versão da API

Agora você pode usar a versão v1.0 do Intune Data Warehouse definindo o parâmetro api-version=v1.0de consulta . Atualizações para coleções no Data Warehouse são aditivas por natureza e não interrompem os cenários existentes.

Você pode experimentar a funcionalidade mais recente do Data Warehouse usando a versão beta. Para usar a versão beta, sua URL deve conter o parâmetro api-version=betade consulta . A versão beta oferece recursos antes que eles sejam disponibilizados como um serviço com suporte. À medida que o Intune adiciona novos recursos, a versão beta pode alterar o comportamento e os contratos de dados. Qualquer código personalizado ou ferramentas de relatório dependentes da versão beta podem falhar com as atualizações em andamento.

Opções de consulta OData

A versão atual dá suporte aos seguintes parâmetros de consulta OData: $filter, $selecte $skip,$top. Em $filter, somente DateKey ou RowLastModifiedDateTimeUTC pode ter suporte quando as colunas forem aplicáveis, e outras propriedades disparariam uma solicitação incorreta.

Filtros de Intervalo de DataKey

DateKey Os filtros de intervalo podem ser usados para limitar a quantidade de dados a serem baixados para algumas das coleções com dateKey como uma propriedade de chave. O DateKey filtro pode ser usado para otimizar o desempenho do serviço fornecendo o seguinte $filter parâmetro de consulta:

1. DateKey sozinho no $filter, apoiando os lt/le/eq/ge/gt operadores e juntando-se ao operador andlógico , onde eles podem ser mapeados para uma data de início e/ou data de término.
2. maxhistorydays é fornecida como uma opção de consulta personalizada.
   

Filtrar exemplos