API för Microsoft Intune-informationslager
Med Api:et för Intune-informationslagret 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 informationslagret 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 datalagerslutpunkterna.
Mer information finns i Hämta data från API:et för informationslager 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:
Datamodell för Intune-informationslager
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 Datamodell för informationslager.
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.