API Microsoft Intune Data Warehouse

A API do Intune Data Warehouse permite que você acesse seus dados Intune em um formato legível por máquina para uso em sua ferramenta de análise favorita. Você pode usar a API para criar relatórios que fornecem informações sobre seu ambiente móvel corporativo. A API usa o protocolo OData, que segue padrões padrão para:

  • Cabeçalhos de solicitação e resposta
  • Códigos de status
  • Métodos HTTP
  • Convenções de URL
  • Tipos de mídia
  • Formatos de conteúdo
  • Opções de consulta

O OData (Open Data Protocol) é um padrão da Organização para o Avanço dos Padrões de Informações Estruturadas (OASIS) que define as melhores práticas para criar e consumir APIs RESTful. O Intune Data Warehouse usa o OData versão 4.0.

Esta seção de referência fornece uma visão geral dos pontos de extremidade, métodos HTTP com suporte, formatos de conteúdo de retorno e documentação do modelo de dados Intune Data Warehouse.

Importante

Você pode experimentar a funcionalidade mais recente do Data Warehouse usando a versão beta. Para usar a versão beta, sua URL deve conter o parâmetro api-version=betade consulta . A versão beta oferece recursos antes que eles sejam disponibilizados como um serviço com suporte. À medida que o Intune adiciona novos recursos, a versão beta pode alterar o comportamento e os contratos de dados. Qualquer código personalizado ou ferramentas de relatório dependentes da versão beta podem falhar com as atualizações em andamento.

Cliente personalizado OData

Você pode acessar o modelo de dados Intune Data Warehouse por meio de pontos de extremidade RESTful. Para obter acesso aos seus dados, seu cliente deve autorizar com o Microsoft Entra ID usando o OAuth 2.0. Primeiro, você configura um aplicativo Web e um aplicativo cliente no Azure, concede permissões ao cliente. Seu cliente local obtém autorização e pode se comunicar com os pontos de extremidade do Data Warehouse.

Para obter mais informações, consulte Obter dados da API do Data Warehouse com um cliente REST.

Observação

Você pode acessar o repositório GitHub Intune Data Warehouse no Github para obter exemplos de código.

Interação com a API

A API requer autorização com o Microsoft Entra ID. O Microsoft Entra ID usa o OAuth 2.0. Depois de autorizado, você pode obter dados da API usando um verbo HTTP GET e contatando as coleções de entidades expostas. Para obter detalhes, confira:

Intune Data Warehouse modelo de dados

O OData define um modelo de dados abstrato e um protocolo que permite que qualquer cliente acesse informações expostas por qualquer fonte de dados. O tópico de documentação do modelo de dados contém uma explicação dos namespaces, entidades e objetos de retorno no Intune Data Warehouse modelo de dados. Para obter mais informações, consulte Modelo de dados do Data Warehouse.

Próximas etapas

Saiba mais sobre como trabalhar com o Microsoft Entra ID lendo os Cenários de Autenticação do Microsoft Entra ID.

Encontre recursos OData em odata.org.

Examine o padrão OData Versão 4.0 em OData Versão 4.0.

  • Last updated on