Microsoft Intune API do Armazém de Dados
A API do Armazém de Dados do Intune permite-lhe aceder aos seus dados do Intune num formato legível por máquina para utilizar na sua ferramenta de análise preferida. Pode utilizar a API para criar relatórios que fornecem informações sobre o ambiente móvel da sua empresa. A API utiliza o protocolo OData, que segue os padrões normais para:
- Cabeçalhos de pedidos e respostas
- Códigos de estado
- Métodos HTTP
- Convenções de URLs
- Tipos de suporte
- Formatos de payload
- Opções de consulta
O OData (Protocolo Open Data) é um padrão de OASIS (Organização para o Avanço dos Padrões de Informação Estruturada) que define a melhor prática para criar e consumir APIs RESTful. O Armazém de Dados do Intune utiliza a versão 4.0 do OData.
Esta secção de referência fornece uma descrição geral dos pontos finais, métodos HTTP suportados, devolução de formatos de payload e documentação do modelo de dados do Armazém de Dados do Intune.
Importante
Pode experimentar as nossas funcionalidades mais recentes do Armazém de Dados com a versão beta. Para utilizar a versão beta, o seu URL tem de conter o parâmetro de consulta api-version=beta. A versão beta oferece funcionalidades antes de estas estarem disponíveis globalmente como um serviço suportado. À medida que o Intune adiciona novas funcionalidades, a versão beta poderá alterar o contrato de dados e comportamento. Todos os códigos personalizados ou ferramentas de relatórios dependentes da versão beta poderão interromper as atualizações contínuas.
Cliente personalizado OData
Pode aceder ao modelo de dados do Armazém de Dados do Intune através de ponto finais RESTful. Para obter acesso aos seus dados, o seu cliente tem de conceder autorização com o Azure Active Directory (Azure AD) com OAuth 2.0. Primeiro configura uma aplicação Web e uma aplicação cliente no Azure, e concede permissões ao cliente. O seu cliente local recebe autorização e pode, em seguida, comunicar com os pontos finais do Armazém de Dados.
Para mais informações, consulte obter dados da API do Data Warehouse com um cliente REST
Nota
Pode aceder ao repositório do Armazém de Dados do Intune no GitHub para obter exemplos de códigos.
Interagir com a API
A API necessita de autorização com o Azure AD. O Azure AD utiliza o OAuth 2.0. Assim que for autorizado, poderá obter dados a partir da API com um verbo HTTP GET e ao contactar as coleções da entidade expostas. Para obter mais detalhes, veja:
Modelo de dados do Armazém de Dados do Intune
O OData define um modelo de dados abstrato e um protocolo que permite a qualquer cliente aceder às informações expostas por qualquer origem de dados. O tópico de documentação do modelo de dados contém uma explicação sobre os espaços de nomes, entidades e objetos devolvidos no modelo de dados do Armazém de Dados do Intune. Para obter mais informações, veja Modelo de Dados do Armazém de Dados.
Passos seguintes
Saiba mais sobre como trabalhar com o Azure AD ao ler Cenários de Autenticação do Azure AD.
Encontre recursos de OData em odata.org.
Consultar a norma da Verão 4.0 de OData em OData Version 4.0 (Versão 4.0 de OData) (https://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part1-protocol.html)