Microsoft Intune Data Warehouse API

Med Intune Data Warehouse-API:et kan du komma åt dina Intune-data i ett maskinläsbart format för användning i ditt favoritanalysverktyg. Du kan använda API:et för att skapa rapporter som ger insikter om din mobila företagsmiljö. API:et använder OData-protokollet, som följer standardmönster för:

  • Begärande- och svarshuvuden
  • Statuskoder
  • HTTP-metoder
  • URL-konventioner
  • Medietyper
  • Nyttolastformat
  • Frågealternativ

OData (Open Data Protocol) är en OASIS-standard (Organization for the Advancement of Structured Information Standards) som definierar bästa praxis för att skapa och använda RESTful-API:er. Intune-Data Warehouse använder OData version 4.0.

Det här referensavsnittet innehåller en översikt över slutpunkter, HTTP-metoder som stöds, returnerade nyttolastformat och dokumentation om Intune Data Warehouse-datamodellen.

Viktigt

Du kan prova de senaste funktionerna i Data Warehouse med hjälp av betaversionen. Om du vill använda betaversionen måste url:en innehålla frågeparametern api-version=beta. Betaversionen erbjuder funktioner innan de görs allmänt tillgängliga som en tjänst som stöds. När Intune lägger till nya funktioner kan betaversionen ändra beteende och datakontrakt. Alla anpassade kod- eller rapporteringsverktyg som är beroende av betaversionen kan brytas med pågående uppdateringar.

Anpassad OData-klient

Du kan komma åt Intune-Data Warehouse datamodellen via RESTful-slutpunkter. För att få åtkomst till dina data måste klienten auktorisera med Microsoft Entra ID med OAuth 2.0. Först konfigurerar du en webbapp och en klientapp i Azure och beviljar behörigheter till klienten. Din lokala klient får auktorisering och kan sedan kommunicera med Data Warehouse slutpunkter.

Mer information finns i Hämta data från Data Warehouse-API:et med en REST-klient.

Obs!

Du kan komma åt GitHub Intune Data Warehouse-lagringsplatsen på Github för kodexempel.

Interagera med API:et

API:et kräver auktorisering med Microsoft Entra ID. Microsoft Entra ID använder OAuth 2.0. När du har auktoriserats kan du hämta data från API:et med hjälp av ett HTTP GET-verb och kontakta de exponerade entitetssamlingarna. Mer information finns i:

Intune Data Warehouse datamodell

OData definierar en abstrakt datamodell och ett protokoll som ger klientåtkomst till information som exponeras av alla datakällor. Dokumentationsavsnittet för datamodellen innehåller en förklaring av namnrymder, entiteter och returobjekt i Intune Data Warehouse-datamodellen. Mer information finns i Data Warehouse datamodell.

Nästa steg

Läs mer om att arbeta med Microsoft Entra ID genom att läsa autentiseringsscenarier för Microsoft Entra ID.

Hitta OData-resurser på odata.org.

Granska OData Version 4.0-standarden på OData version 4.0.