API do Armazém de Dados do Microsoft Intune

  • Artigo

A API do Armazém de Dados do Intune permite-lhe aceder aos seus dados do 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 Armazém de Dados do Intune 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 do Armazém de Dados do Intune.

Importante

Pode experimentar as funcionalidades mais recentes do Armazém de Dados 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.

Cliente personalizado OData

Pode aceder ao modelo de dados do Armazém de Dados do Intune através de pontos finais RESTful. Para obter acesso aos seus dados, o cliente tem de autorizar com o Microsoft Entra ID através do 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 do Armazém de Dados.

Para obter mais informações, veja Obter dados da API do Armazém de Dados com um cliente REST.

Observação

Pode aceder ao repositório do GitHub Intune Data Warehouse no Github para obter exemplos de código.

Interagir com a API

A API requer autorização com o Microsoft Entra ID. O 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:

Modelo de dados do Armazém de Dados do Intune

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 de retorno 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.

Próximas etapas

Saiba mais sobre como trabalhar com o Microsoft Entra ID ao ler Os Cenários de Autenticação do 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.