Microsoft Intune Data Warehouse-API
Met de Intune Data Warehouse-API hebt u toegang tot uw Intune-gegevens in een machineleesbare indeling voor gebruik in uw favoriete analyseprogramma. U kunt de API gebruiken om rapporten te maken die inzicht bieden in uw mobiele bedrijfsomgeving. De API maakt gebruik van het OData-protocol, dat standaardpatronen volgt voor:
- Aanvraag- en antwoordheaders
- Statuscodes
- HTTP-methoden
- URL-conventies
- Mediatypen
- Payload-indelingen
- Queryopties
OData (Open Data Protocol) is een OASIS-standaard (Organization for the Advancement of Structured Information Standards) die de best practice definieert voor het bouwen en gebruiken van RESTful API's. Het Intune-datawarehouse maakt gebruik van OData-versie 4.0.
Deze sectie bevat een overzicht van eindpunten, ondersteunde HTTP-methoden, indelingen voor nettoladingen en documentatie van het Intune Data Warehouse-gegevensmodel.
Belangrijk
U kunt de nieuwste functionaliteit van het datawarehouse uitproberen met behulp van de bètaversie. Als u de bètaversie wilt gebruiken, moet uw URL de queryparameter api-version=betabevatten. De bètaversie biedt functies voordat ze algemeen beschikbaar worden gemaakt als een ondersteunde service. Wanneer Intune nieuwe functies toevoegt, kan de bètaversie het gedrag en de gegevenscontracten wijzigen. Aangepaste code of rapportagehulpprogramma's die afhankelijk zijn van de bètaversie, kunnen worden onderbroken door doorlopende updates.
Aangepaste OData-client
U hebt toegang tot het Intune Data Warehouse-gegevensmodel via RESTful-eindpunten. Om toegang te krijgen tot uw gegevens, moet uw client autoriseren met Microsoft Entra ID met behulp van OAuth 2.0. U stelt eerst een web-app en een client-app in Azure in en verleent machtigingen aan de client. Uw lokale client krijgt autorisatie en kan vervolgens communiceren met de datawarehouse-eindpunten.
Zie Gegevens ophalen uit de Data Warehouse-API met een REST-client voor meer informatie.
Opmerking
U hebt toegang tot de Opslagplaats van GitHub Intune-datawarehouse op Github voor codevoorbeelden.
Interactie met de API
Voor de API is autorisatie met Microsoft Entra ID vereist. Microsoft Entra ID maakt gebruik van OAuth 2.0. Zodra dit is geautoriseerd, kunt u gegevens ophalen uit de API met behulp van een HTTP GET-werkwoord en contact opnemen met de weergegeven entiteitsverzamelingen. Zie voor meer informatie:
Intune Data Warehouse-gegevensmodel
OData definieert een abstract gegevensmodel en een protocol waarmee elke client toegang heeft tot informatie die door een gegevensbron wordt weergegeven. Het documentatieonderwerp voor gegevensmodellen bevat een uitleg van de naamruimten, entiteiten en retourobjecten in het Intune Data Warehouse-gegevensmodel. Zie DataWarehouse-gegevensmodel voor meer informatie.
Volgende stappen
Lees verificatiescenario's voor Microsoft Entra ID voor meer informatie over het werken met Microsoft Entra ID.
Zoek OData-resources op odata.org.
Bekijk de OData-versie 4.0-standaard op OData-versie 4.0.