Microsoft Intune Data Warehouse API
L'API Data Warehouse di Intune consente di accedere ai dati di 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. 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 di Intune Data Warehouse.
Importante
È possibile provare le funzionalità più recenti di 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 di Intune Data Warehouse tramite endpoint RESTful. Per ottenere l'accesso ai dati, il client deve autorizzare con l'ID Microsoft Entra 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 di Data Warehouse.
Per altre informazioni, vedere Ottenere dati dall'API Data Warehouse con un client REST.
Nota
È possibile accedere al repository GitHub Intune Data Warehouse in Github per gli esempi di codice.
Interazione con l'API
L'API richiede l'autorizzazione con l'ID Microsoft Entra. 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 di 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 di Intune Data Warehouse. Per altre informazioni, vedere Modello di dati del data warehouse.
Passaggi successivi
Per altre informazioni sull'uso di Microsoft Entra ID, vedere Scenari di autenticazione per l'ID Microsoft Entra.
Trovare le risorse OData in odata.org.
Esaminare lo standard OData versione 4.0 in OData versione 4.0.