Condividi tramite

API Microsoft Intune Data Warehouse

  • Articolo

L'API Intune Data Warehouse consente di accedere ai dati Intune in un formato leggibile dal computer per l'uso nello strumento di analisi preferito. È possibile usare l'API per creare report che forniscono informazioni dettagliate sull'ambiente mobile aziendale. L'API usa il protocollo OData, che segue i modelli standard per:

  • Intestazioni di richiesta e risposta
  • Codici di stato
  • Metodi HTTP
  • Convenzioni URL
  • Tipi di supporti
  • Formati di payload
  • Opzioni di query

OData (Open Data Protocol) è uno standard OASIS (Organization for the Advancement of Structured Information Standards) che definisce la procedura consigliata per la creazione e l'utilizzo di API RESTful. Il Intune Data Warehouse usa OData versione 4.0.

Questa sezione di riferimento offre una panoramica degli endpoint, dei metodi HTTP supportati, dei formati di payload restituiti e della documentazione del modello di dati Intune Data Warehouse.

Importante

È possibile provare le funzionalità più recenti del Data Warehouse usando la versione beta. Per usare la versione beta, l'URL deve contenere il parametro api-version=betadi query . La versione beta offre funzionalità prima che vengano rese disponibili a livello generale come servizio supportato. Quando Intune aggiunge nuove funzionalità, la versione beta può modificare il comportamento e i contratti dati. Qualsiasi codice personalizzato o strumento di creazione di report dipendente dalla versione beta potrebbe interrompersi con gli aggiornamenti in corso.

Client personalizzato OData

È possibile accedere al modello di dati Intune Data Warehouse tramite endpoint RESTful. Per ottenere l'accesso ai dati, il client deve autorizzare con Microsoft Entra ID usando OAuth 2.0. È prima di tutto necessario configurare un'app Web e un'app client in Azure e concedere le autorizzazioni al client. Il client locale ottiene l'autorizzazione e può quindi comunicare con gli endpoint Data Warehouse.

Per altre informazioni, vedere Ottenere dati dall'API Data Warehouse con un client REST.

Nota

È possibile accedere al repository Intune Data Warehouse di GitHub in Github per esempi di codice.

Interazione con l'API

L'API richiede l'autorizzazione con Microsoft Entra ID. Microsoft Entra ID usa OAuth 2.0. Dopo l'autorizzazione, è possibile ottenere dati dall'API usando un verbo HTTP GET e contattando le raccolte di entità esposte. Per informazioni dettagliate, vedere:

modello di dati Intune Data Warehouse

OData definisce un modello di dati astratto e un protocollo che consentono a qualsiasi client di accedere alle informazioni esposte da qualsiasi origine dati. L'argomento della documentazione del modello di dati contiene una spiegazione degli spazi dei nomi, delle entità e degli oggetti restituiti nel modello di dati Intune Data Warehouse. Per altre informazioni, vedere Data Warehouse Data Model.

Passaggi successivi

Per altre informazioni sull'uso di Microsoft Entra ID, vedere Scenari di autenticazione per Microsoft Entra ID.

Trovare le risorse OData in odata.org.

Esaminare lo standard OData versione 4.0 in OData versione 4.0.