Intune Data Warehouse API-végpont

Cikk
12/21/2023

Az Intune Data Warehouse API-t egy adott szerepköralapú hozzáférés-vezérléssel és Microsoft Entra hitelesítő adatokkal rendelkező fiókkal használhatja. Ezután az OAuth 2.0 használatával engedélyezi a REST-ügyfelet Microsoft Entra azonosítóval. Végül pedig egy jelentéssel bíró URL-címet fog létrehozni egy adattárház-erőforrás meghívásához.

az azonosító és az Intune hitelesítő adatainak Microsoft Entra követelményei

A hitelesítés és engedélyezés Microsoft Entra hitelesítő adatokon és az Intune szerepköralapú hozzáférés-vezérlésén (RBAC) alapul. A bérlő összes globális rendszergazdája és Intune-szolgáltatásadminisztrátora alapértelmezés szerint hozzáfér az adattárházhoz. Az Intune-szerepkörök használatával több felhasználó számára biztosíthat hozzáférést az Intune-adattárház-erőforráshoz való hozzáféréssel.

Az Intune Data Warehouse elérésének követelményei (beleértve az API-t is) a következők:

A felhasználónak a következők egyikének kell lennie:
- Microsoft Entra globális rendszergazda
- Intune-szolgáltatásadminisztrátor
- Az Intune-adattárház-erőforráshoz szerepköralapú hozzáféréssel rendelkező felhasználó
- Felhasználó nélküli hitelesítés csak alkalmazásalapú hitelesítéssel

Fontos

Intune-szerepkör hozzárendeléséhez és az Intune-Data Warehouse eléréséhez a felhasználónak Intune-licenccel kell rendelkeznie. További információ: Szerepköralapú hozzáférés-vezérlés (RBAC) Microsoft Intune és Microsoft Intune licenceléssel.

Engedélyezési

Microsoft Entra id az OAuth 2.0-t használja a webalkalmazásokhoz és webes API-khoz való hozzáférés engedélyezéséhez a Microsoft Entra bérlőben. Ez az útmutató nyelvfüggetlen, és azt ismerteti, hogyan küldhet és fogadhat HTTP-üzeneteket nyílt forráskódú kódtárak használata nélkül. Az OAuth 2.0 engedélyezési kódfolyamatát az OAuth 2.0 specifikációjának 4.1-es szakasza ismerteti.

További információ: Hozzáférés engedélyezése webalkalmazásokhoz az OAuth 2.0 és Microsoft Entra id használatával.

API URL-struktúrája

A Data Warehouse API-végpontok beolvasják az egyes halmazok entitásait. Az API támogatja a GET HTTP-parancsot és a lekérdezési beállítások egy részhalmazát.

Az Intune URL-címe a következő formátumot használja:
https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

Megjegyzés:

A fenti URL-címben cserélje le {location}a , {entity-collection}a és {api-version} a kifejezést az alábbi táblázatban megadott adatok alapján.

Az URL-cím a következő elemeket tartalmazza:

Elem	Példa	Leírás
Helyen	msua06	Az alap URL-cím a Microsoft Intune Felügyeleti központ Data Warehouse API paneljén található.
entitásgyűjtemény	devicePropertyHistories	Az OData-entitásgyűjtemény neve. Az adatmodellben található gyűjteményekkel és entitásokkal kapcsolatos további információkért lásd: Adatmodell.
api-version	Béta	A verzió az elérni kívánt API verziója. További információ: Verzió.
maxhistorydays	7	(Nem kötelező) A beolvasandó előzmény napok maximális száma. Ez a paraméter bármely gyűjteményhez megadható, de csak olyan gyűjtemények esetében lép érvénybe, amelyek a kulcstulajdonság részeként szerepelnek `dateKey` . További információ: DateKey Tartományszűrők .

API-verzióinformációk

Most már használhatja az Intune Data Warehouse 1.0-s verzióját a lekérdezési paraméter api-version=v1.0beállításával. Frissítések a Data Warehouse gyűjtemények additív jellegűek, és nem szakítják meg a meglévő forgatókönyveket.

A bétaverzióval kipróbálhatja a Data Warehouse legújabb funkcióit. A bétaverzió használatához az URL-címnek tartalmaznia kell a lekérdezési paramétert api-version=beta. A bétaverzió még azelőtt kínál funkciókat, hogy azok általánosan elérhetőek lennének támogatott szolgáltatásként. Ahogy az Intune új funkciókat ad hozzá, a bétaverzió megváltoztathatja a viselkedést és az adatszerződéseket. A bétaverziótól függő egyéni kód vagy jelentéskészítő eszközök megszakíthatják a folyamatban lévő frissítéseket.

OData-lekérdezési beállítások

Az aktuális verzió a következő OData lekérdezési paramétereket támogatja: $filter, $select$skip, és $top. A-ben $filtercsak DateKey vagy RowLastModifiedDateTimeUTC akkor támogatott, ha az oszlopok alkalmazhatók, és más tulajdonságok rossz kérést váltanak ki.

DateKey tartományszűrők

DateKey A tartományszűrők használatával korlátozható egyes kulcstulajdonságként használt gyűjtemények dateKey letöltési adatainak mennyisége. A DateKey szűrő a szolgáltatás teljesítményének optimalizálására használható a következő $filter lekérdezési paraméter megadásával:

DateKey csak a $filter-ben, az operátorok támogatása és a lt/le/eq/ge/gt logikai operátorhoz andvaló csatlakozás, ahol leképezhetők a kezdő dátumra és/vagy a záró dátumra.
maxhistorydays egyéni lekérdezési lehetőségként van megadva.

Példák szűrése