Intune Data Warehouse API-eindpunt

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 het Intune-datawarehouse (inclusief de API):

• Gebruiker moet een van de volgende zijn:
  • Globale beheerder van 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 het Intune-datawarehouse. Zie Op rollen gebaseerd toegangsbeheer (RBAC) met Microsoft Intune- en Microsoft Intune-licenties voor meer informatie.

Machtiging

Microsoft Entra ID maakt gebruik van 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 behulp van OAuth 2.0 en Microsoft Entra ID voor meer informatie.

API-URL-structuur

De datawarehouse-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	Beschrijving
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 het Intune-datawarehouse gebruiken door de queryparameter api-version=v1.0in te stellen. Updates van verzamelingen in het datawarehouse zijn additief van aard en vormen geen onderbreking van bestaande scenario's.

U kunt de nieuwste functionaliteit van het datawarehouse 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:

1. 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.
2. maxhistorydays wordt opgegeven als aangepaste queryoptie.
   

Filtervoorbeelden

Opmerking

In de filtervoorbeelden wordt ervan uitgegaan dat het vandaag 21-02-2018 is.

Filter	Prestatieoptimalisatie	Beschrijving
maxhistorydays=7	Vol	Gegevens retourneren met DateKey tussen 20180214 en 20180221.
$filter=DateKey eq 20180214	Vol	Gegevens retourneren met DateKey gelijk aan 20180214.
$filter=DateKey ge 20180214 and DateKey lt 20180221	Vol	Gegevens retourneren met DateKey tussen 20180214 en 20180220.
maxhistorydays=7&$filter=DateKey eq 20180214	Vol	Gegevens retourneren met DateKey gelijk aan 20180214. maxhistorydays wordt genegeerd.
$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z	Vol	Gegevens retourneren met RowLastModifiedDateTimeUTC is groter dan of gelijk aan 2018-02-21T23:18:51.3277273Z