Api-slutpunkt för Intune-informationslager

Artikel
07/30/2024

Du kan använda Intune Data Warehouse-API:et med ett konto med specifika rollbaserade åtkomstkontroller och Microsoft Entra-autentiseringsuppgifter. Sedan auktoriserar du REST-klienten med Microsoft Entra-ID med hjälp av OAuth 2.0. Slutligen skapar du en meningsfull URL för att anropa en informationslagerresurs.

Krav för Microsoft Entra-ID och Intune-autentiseringsuppgifter

Autentisering och auktorisering baseras på Microsoft Entra-autentiseringsuppgifter och rollbaserad åtkomstkontroll i Intune (RBAC). Alla globala administratörer och Intune-tjänstadministratörer för din klientorganisation har som standard åtkomst till informationslagret. Använd Intune-roller för att ge åtkomst till fler användare genom att ge dem åtkomst till Intune-informationslagerresursen .

Krav för åtkomst till Intune-informationslagret (inklusive API:et) är:

Användaren måste vara en av:
- Global administratör för Microsoft Entra
- En Intune-tjänstadministratör
- Användare med rollbaserad åtkomst till Intune-informationslagerresurs
- Användarlös autentisering med programbaserad autentisering

Viktigt

För att tilldelas en Intune-roll och få åtkomst till Intune-informationslagret måste användaren ha en Intune-licens. Mer information finns i Rollbaserad åtkomstkontroll (RBAC) med Microsoft Intune och Microsoft Intune-licensiering.

Tillstånd

Microsoft Entra ID använder OAuth 2.0 för att ge dig åtkomst till webbprogram och webb-API:er i din Microsoft Entra-klientorganisation. Den här guiden är språkoberoende och beskriver hur du skickar och tar emot HTTP-meddelanden utan att använda bibliotek med öppen källkod. OAuth 2.0-auktoriseringskodflödet beskrivs i avsnitt 4.1 i OAuth 2.0-specifikationen.

Mer information finns i Auktorisera åtkomst till webbprogram med OAuth 2.0 och Microsoft Entra ID.

API-URL-struktur

Api-slutpunkterna för informationslagret läser entiteterna för varje uppsättning. API:et stöder ett GET HTTP-verb och en delmängd av frågealternativen.

URL:en för Intune använder följande format:
https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

Obs!

I ovanstående URL ersätter {location}du , {entity-collection}och {api-version} baserat på informationen i tabellen nedan.

URL:en innehåller följande element:

Element	Exempel	Beskrivning
plats	msua06	Du hittar bas-URL:en genom att visa bladet API för informationslager i administrationscentret för Microsoft Intune.
entitetssamling	devicePropertyHistories	Namnet på OData-entitetssamlingen. Mer information om samlingar och entiteter i datamodellen finns i Datamodell.
api-version	beta	Versionen är den version av API:et som ska kommas åt. Mer information finns i Version.
maxhistorydays	7	(Valfritt) Det maximala antalet dagar med historik som ska hämtas. Den här parametern kan skickas till alla samlingar, men börjar bara gälla för samlingar som ingår `dateKey` som en del av deras nyckelegenskap. Mer information finns i DateKey-intervallfilter .

Information om API-version

Du kan nu använda v1.0-versionen av Intune Data Warehouse genom att ange frågeparametern api-version=v1.0. Uppdateringar av samlingar i informationslagret är additiva och bryter inte befintliga scenarier.

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.

OData-frågealternativ

Den aktuella versionen stöder följande OData-frågeparametrar: $filter, $select$skip, och $top. I $filterkan endast DateKey eller RowLastModifiedDateTimeUTC stöds när kolumnerna är tillämpliga och andra egenskaper utlöser en felaktig begäran.

DateKey-intervallfilter

DateKey intervallfilter kan användas för att begränsa mängden data som ska laddas ned för vissa av samlingarna med dateKey som en nyckelegenskap. Filtret DateKey kan användas för att optimera tjänstens prestanda genom att ange följande $filter frågeparameter:

DateKey ensam i $filter, som stöder operatorerna lt/le/eq/ge/gt och ansluter till logikoperatorn and, där de kan mappas till ett startdatum och/eller slutdatum.
maxhistorydays anges som anpassat frågealternativ.

Filterexempel

Obs!

Filterexemplen förutsätter att dagens datum är 2018-02-21.

Filter	Prestandaoptimering	Beskrivning
`maxhistorydays=7`	Full	Returnera data med `DateKey` mellan 20180214 och 20180221.
`$filter=DateKey eq 20180214`	Full	Returnera data med `DateKey` samma 20180214.
`$filter=DateKey ge 20180214 and DateKey lt 20180221`	Full	Returnera data med `DateKey` mellan 20180214 och 20180220.
`maxhistorydays=7&$filter=DateKey eq 20180214`	Full	Returnera data med `DateKey` samma 20180214. `maxhistorydays` ignoreras.
`$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z`	Full	Returdata med är större än eller lika med `RowLastModifiedDateTimeUTC2018-02-21T23:18:51.3277273Z`

Dela via