Ponto Final da API do Intune Data Warehouse

Pode utilizar a API de Data Warehouse do Intune com uma conta com controlos de acesso baseados em funções específicos e credenciais de Microsoft Entra. Em seguida, irá autorizar o cliente REST com Microsoft Entra ID com o OAuth 2.0. Por fim, irá formar um URL significativo para chamar um recurso do armazém de dados.

requisitos de ID de Microsoft Entra e credenciais do Intune

A autenticação e a autorização baseiam-se em credenciais Microsoft Entra e no controlo de acesso baseado em funções (RBAC) do Intune. Todos os Administradores do Intune do seu inquilino têm acesso ao Armazém de dados por predefinição. Utilize as funções do Intune para fornecer acesso a mais utilizadores ao conceder-lhes acesso ao recurso do armazém de dados do Intune .

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

• O utilizador tem de ter, no mínimo, uma das seguintes funções:
  • Um administrador de serviços do Intune
  • Utilizador com acesso baseado em funções ao recurso do armazém de dados do Intune
  • Autenticação sem utilizador através da autenticação apenas de aplicação

Authorization

Microsoft Entra ID utiliza o OAuth 2.0 para lhe permitir autorizar o acesso a aplicações Web e APIs Web no seu inquilino Microsoft Entra. Este guia é independente de linguagem e descreve como enviar e receber mensagens HTTP sem utilizar bibliotecas open source. O fluxo de código de autorização OAuth 2.0 está descrito na secção 4.1 da especificação OAuth 2.0.

Para obter mais informações, veja Autorizar o acesso a aplicações Web com o OAuth 2.0 e Microsoft Entra ID.

Estrutura do URL da API

Os pontos finais da API Data Warehouse leem as entidades de cada conjunto. A API suporta um verbo GET HTTP e um subconjunto de opções de consulta.

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

O URL contém os seguintes elementos:

Informações da versão da API

Agora, pode utilizar a versão v1.0 do intune Data Warehouse ao definir o parâmetro api-version=v1.0de consulta . Atualizações a coleções na Data Warehouse são aditivas por natureza e não interrompem cenários existentes.

Pode experimentar as funcionalidades mais recentes do Data Warehouse com a versão beta. Para utilizar a versão beta, o URL tem de conter o parâmetro api-version=betade consulta . A versão beta oferece funcionalidades antes de serem disponibilizadas geralmente como um serviço suportado. À medida que o Intune adiciona novas funcionalidades, a versão beta pode alterar o comportamento e os contratos de dados. Qualquer código personalizado ou ferramentas de relatórios dependentes da versão beta podem interromper as atualizações em curso.

Opções de consulta OData

A versão atual suporta os seguintes parâmetros de consulta OData: $filter, $selecte $skip,$top. No $filter, apenas DateKey ou RowLastModifiedDateTimeUTC pode ser suportado quando as colunas são aplicáveis e outras propriedades acionam um pedido incorreto.

Filtros de Intervalo DateKey

DateKey os filtros de intervalo podem ser utilizados para limitar a quantidade de dados a transferir para algumas das coleções com dateKey como uma propriedade chave. O DateKey filtro pode ser utilizado para otimizar o desempenho do serviço ao fornecer o seguinte $filter parâmetro de consulta:

1. DateKey apenas no , suportando $filteros lt/le/eq/ge/gt operadores e associando-se ao operador andlógico , onde podem ser mapeados para uma data de início e/ou data de fim.
2. maxhistorydays é fornecido como opção de consulta personalizada.
   

Exemplos de filtro