Microsoft Intune Data Warehouse API

  • Artikel

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. De Intune-Data Warehouse 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 de Data Warehouse 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 Data Warehouse eindpunten.

Zie Gegevens ophalen uit de Data Warehouse API met een REST-client voor meer informatie.

Opmerking

U hebt toegang tot de GitHub Intune-Data Warehouse-opslagplaats op Github voor codevoorbeelden.

Interactie met de API

De API vereist autorisatie met Microsoft Entra ID. 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 Data Warehouse-gegevensmodel voor meer informatie.

Volgende stappen

Lees de 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.