Ponto de extremidade da API do Intune Data Warehouse

Pode utilizar a API de Intune Data Warehouse 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 credenciais Microsoft Entra ID e Intune

A autenticação e a autorização baseiam-se em credenciais Microsoft Entra e Intune controlo de acesso baseado em funções (RBAC). Todos os administradores globais e Intune administradores de serviços do seu inquilino têm acesso ao Armazém de dados por predefinição. Utilize Intune funções para fornecer acesso a mais utilizadores ao conceder-lhes acesso ao recurso do armazém de dados 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 Intune recurso do armazém de dados
  • Autenticação sem utilizador através da autenticação apenas de aplicação

Importante

Para lhe ser atribuída uma função de Intune e aceder ao Intune Data Warehouse, o utilizador tem de ter uma licença de Intune. Para obter mais informações, veja Controlo de acesso baseado em funções (RBAC) com licenciamento de Microsoft Intune e Microsoft Intune.

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 para Intune utiliza o seguinte formato:
https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

Observação

No URL acima, substitua {location}, {entity-collection}e {api-version} com base nos detalhes fornecidos na tabela abaixo.

O URL contém os seguintes elementos:

Elemento	Exemplo	Descrição
localização	msua06	O URL base pode ser encontrado ao visualizar o painel da API Data Warehouse no centro de administração do Microsoft Intune.
coleção de entidades	devicePropertyHistories	O nome da coleção de entidades OData. Para obter mais informações sobre coleções e entidades no modelo de dados, veja Modelo de Dados.
versão da API	beta	A versão é a versão da API a aceder. Para obter mais informações, consulte Versão.
maxhistorydays	7	(Opcional) O número máximo de dias do histórico a obter. Este parâmetro pode ser fornecido a qualquer coleção, mas só produzirá efeitos para coleções que incluam dateKey como parte da respetiva propriedade chave. Veja Filtros de Intervalo DateKey para obter mais informações.

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 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

Observação

Os exemplos de filtro partem do princípio de que hoje é 21/02/2018.

Filter	Otimização do Desempenho	Descrição
maxhistorydays=7	Completo	Devolver dados com DateKey entre 20180214 e 20180221.
$filter=DateKey eq 20180214	Inteiro	Devolver dados com DateKey igual a 20180214.
$filter=DateKey ge 20180214 and DateKey lt 20180221	Inteiro	Devolver dados com DateKey entre 20180214 e 20180220.
maxhistorydays=7&$filter=DateKey eq 20180214	Inteiro	Devolver dados com DateKey igual a 20180214. maxhistorydays é ignorado.
$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z	Inteiro	Devolver dados com RowLastModifiedDateTimeUTC é maior ou igual a 2018-02-21T23:18:51.3277273Z