API Microsoft Intune Data Warehouse

  • Artigo

A API Data Warehouse do Intune permite que você acesse seus dados do Intune em um formato legível por computador para uso em sua ferramenta de análise favorita. Você pode usar a API para criar relatórios que fornecem insights 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 carga
  • Opções de consulta

O OData (Protocolo de Dados Abertos) é um padrão oasis (Organization for the Advancement of Structured Information Standards) que define as melhores práticas para criar e consumir APIs RESTful. O Data Warehouse do Intune usa o OData versão 4.0.

Esta seção de referência fornece uma visão geral de pontos de extremidade, métodos HTTP com suporte, formatos de carga de retorno e documentação do modelo de dados do 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 de serem disponibilizados geralmente 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 pode ser interrompido com atualizações em andamento.

Cliente personalizado OData

Você pode acessar o modelo de dados Data Warehouse do Intune por meio de pontos de extremidade RESTful. Para obter acesso aos seus dados, seu cliente deve autorizar com 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 Data Warehouse.

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

Observação

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

Interagindo com a API

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

Modelo de dados Data Warehouse do Intune

O OData define um modelo de dados abstrato e um protocolo que permitem 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 retornados no modelo de dados do Intune Data Warehouse. Para obter mais informações, consulte Data Warehouse Modelo de Dados.

Próximas etapas

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

Encontre recursos OData em odata.org.

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