API de Microsoft Intune Data Warehouse
A API de Intune Data Warehouse permite-lhe aceder aos seus dados de Intune num formato legível por computador para utilização na sua ferramenta de análise favorita. Pode utilizar a API para criar relatórios que forneçam informações sobre o seu ambiente móvel empresarial. A API utiliza o protocolo OData, que segue padrões padrão para:
- Cabeçalhos de pedido e resposta
- Códigos de status
- Métodos HTTP
- Convenções de URL
- Tipos de multimédia
- Formatos de payload
- Opções de consulta
O OData (Open Data Protocol) é uma Organização para o Avanço das Normas de Informação Estruturada (OASIS) que define a melhor prática para criar e consumir APIs RESTful. O Intune Data Warehouse utiliza a versão OData 4.0.
Esta secção de referência fornece uma descrição geral dos pontos finais, métodos HTTP suportados, formatos de payload de devolução e documentação do modelo de dados Intune Data Warehouse.
Importante
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.
Cliente personalizado OData
Pode aceder ao modelo de dados Intune Data Warehouse através de pontos finais RESTful. Para obter acesso aos seus dados, o cliente tem de autorizar com Microsoft Entra ID com o OAuth 2.0. Primeiro configurou uma aplicação Web e uma aplicação cliente no Azure e concede permissões ao cliente. O cliente local obtém autorização e, em seguida, pode comunicar com os pontos finais Data Warehouse.
Para obter mais informações, veja Obter dados da API Data Warehouse com um cliente REST.
Observação
Pode aceder ao repositório de Intune Data Warehouse do GitHub no Github para obter exemplos de código.
Interagir com a API
A API requer autorização com Microsoft Entra ID. Microsoft Entra ID utiliza o OAuth 2.0. Depois de autorizado, pode obter dados da API com um verbo HTTP GET e contactar as coleções de entidades expostas. Para obter detalhes, veja:
Intune Data Warehouse modelo de dados
O OData define um modelo de dados abstrato e um protocolo que permite que qualquer cliente aceda às informações expostas por qualquer origem de dados. O tópico de documentação do modelo de dados contém uma explicação dos espaços de nomes, entidades e objetos devolvidos no modelo de dados Intune Data Warehouse. Para obter mais informações, veja Data Warehouse Modelo de Dados.
Próximas etapas
Saiba mais sobre como trabalhar com Microsoft Entra ID ao ler Os Cenários de Autenticação para Microsoft Entra ID.
Localize os recursos OData na odata.org.
Reveja o padrão OData Versão 4.0 em OData Versão 4.0.