Intune Data Warehouse API-slutpunkt

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

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

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

Kraven för att få åtkomst till Intune Data Warehouse (inklusive API) är:

• Användaren måste ha minst en av följande roller:
  • En Intune tjänstadministratör
  • Användare med rollbaserad åtkomst till Intune informationslagerresurs
  • Användarlös autentisering med programspecifik autentisering

Behörighet

Microsoft Entra ID använder OAuth 2.0 så att du kan auktorisera åtkomst till webbprogram och webb-API 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 Data Warehouse läser enheterna för varje uppsättning. API:et stöder ett GET HTTP-verb och en delmängd frågealternativ.

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

URL-adressen innehåller följande element:

Information om API-version

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

Du kan prova de senaste funktionerna i Data Warehouse med betaversionen. Om du vill använda betaversionen måste webbadressen 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. Anpassad kod eller rapporteringsverktyg som är beroende av betaversionen kan sluta fungera med pågående uppdateringar.

Frågealternativ för OData

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

Intervallfilter för datumnyckel

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:

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

Filterexempel