Intune Data Warehouse API-eindpunt

Artikel
12/21/2023

U kunt de Intune Data Warehouse-API gebruiken met een account met specifieke op rollen gebaseerde toegangsbeheer en Microsoft Entra referenties. Vervolgens autoriseert u uw REST-client met Microsoft Entra-id met behulp van OAuth 2.0. En ten slotte vormt u een zinvolle URL om een datawarehouse-resource aan te roepen.

vereisten voor Microsoft Entra-id en Intune-referenties

Verificatie en autorisatie zijn gebaseerd op Microsoft Entra referenties en op rollen gebaseerd toegangsbeheer (RBAC) van Intune. Alle globale beheerders en Intune-servicebeheerders voor uw tenant hebben standaard toegang tot het datawarehouse. Gebruik Intune-rollen om meer gebruikers toegang te bieden door ze toegang te geven tot de Intune-datawarehouse-resource .

Vereisten voor toegang tot de Intune-Data Warehouse (inclusief de API):

Gebruiker moet een van de volgende zijn:
- globale beheerder Microsoft Entra
- Een Intune-servicebeheerder
- Gebruiker met op rollen gebaseerde toegang tot Intune-datawarehouse-resource
- Gebruikersloze verificatie met alleen-toepassingsverificatie

Belangrijk

De gebruiker moet een Intune-licentie hebben om een Intune-rol toe te wijzen en toegang te krijgen tot de Intune-Data Warehouse. Zie Op rollen gebaseerd toegangsbeheer (RBAC) met Microsoft Intune- en Microsoft Intune-licenties voor meer informatie.

Vergunning

Microsoft Entra-id gebruikt OAuth 2.0 om toegang te verlenen tot webtoepassingen en web-API's in uw Microsoft Entra tenant. Deze handleiding is taalonafhankelijk en beschrijft hoe u HTTP-berichten verzendt en ontvangt zonder opensource-bibliotheken te gebruiken. De OAuth 2.0-autorisatiecodestroom wordt beschreven in sectie 4.1 van de OAuth 2.0-specificatie.

Zie Toegang tot webtoepassingen autoriseren met OAuth 2.0 en Microsoft Entra-id voor meer informatie.

API-URL-structuur

De Data Warehouse API-eindpunten lezen de entiteiten voor elke set. De API ondersteunt een GET HTTP-werkwoord en een subset van queryopties.

De URL voor Intune gebruikt de volgende indeling:
https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

Opmerking

Vervang {location}in de bovenstaande URL , {entity-collection}en {api-version} op basis van de details in de onderstaande tabel.

De URL bevat de volgende elementen:

Element	Voorbeeld	Omschrijving
locatie	msua06	U vindt de basis-URL door de blade Data Warehouse API te bekijken in het Microsoft Intune-beheercentrum.
entiteitsverzameling	devicePropertyHistories	De naam van de OData-entiteitsverzameling. Zie Gegevensmodel voor meer informatie over verzamelingen en entiteiten in het gegevensmodel.
api-versie	Beta	Versie is de versie van de API die moet worden geopend. Zie Versie voor meer informatie.
maxhistorydays	7	(Optioneel) Het maximum aantal dagen geschiedenis dat moet worden opgehaald. Deze parameter kan worden geleverd aan elke verzameling, maar wordt alleen van kracht voor verzamelingen die deel uitmaken `dateKey` van de sleuteleigenschap. Zie Datumsleutelbereikfilters voor meer informatie.

API-versie-informatie

U kunt nu de versie v1.0 van de Intune-Data Warehouse gebruiken door de queryparameter api-version=v1.0in te stellen. Updates verzamelingen in de Data Warehouse zijn additief van aard en vormen geen onderbreking van bestaande scenario's.

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.

OData-queryopties

De huidige versie ondersteunt de volgende OData-queryparameters: $filter, $selecten $top$skip, . In $filterwordt alleen DateKey of RowLastModifiedDateTimeUTC ondersteund wanneer de kolommen van toepassing zijn en andere eigenschappen een ongeldige aanvraag activeren.

Datumsleutelbereikfilters

DateKey bereikfilters kunnen worden gebruikt om de hoeveelheid gegevens te downloaden voor sommige verzamelingen te beperken met dateKey als sleuteleigenschap. Het DateKey filter kan worden gebruikt om de serviceprestaties te optimaliseren door de volgende $filter queryparameter op te geven:

DateKey alleen in de $filter, die de lt/le/eq/ge/gt operators ondersteunt en wordt gekoppeld aan de logische operator and, waar ze kunnen worden toegewezen aan een begin- en/of einddatum.
maxhistorydays wordt opgegeven als aangepaste queryoptie.

Filtervoorbeelden