Intune Data Warehouse API-végpont

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 ID. 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.

Microsoft Entra ID és Intune hitelesítő adatokra vonatkozó követelmények

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

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

• A felhasználónak legalább az alábbi szerepkörök egyikével kell rendelkeznie:
  • Intune szolgáltatásadminisztrátor
  • Szerepköralapú hozzáféréssel rendelkező felhasználó Intune adattárház-erőforráshoz
  • Felhasználó nélküli hitelesítés csak alkalmazásalapú hitelesítéssel

Fontos

Egy Intune szerepkör hozzárendeléséhez és a 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.

A 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 a 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 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:

1. 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.
2. maxhistorydays egyéni lekérdezési lehetőségként van megadva.
   

Példák szűrése

Megjegyzés:

A szűrési példák feltételezik, hogy ma 2018. 02. 21.

Szűrő	Teljesítményoptimalizálás	Leírás
maxhistorydays=7	Teljes	Adatokat DateKey ad vissza 20180214 és 20180221 között.
$filter=DateKey eq 20180214	Teljes	A 20180214 egyenlő adatokat DateKey adja vissza.
$filter=DateKey ge 20180214 and DateKey lt 20180221	Teljes	Adatokat DateKey ad vissza 20180214 és 20180220 között.
maxhistorydays=7&$filter=DateKey eq 20180214	Teljes	A 20180214 egyenlő adatokat DateKey adja vissza. maxhistorydays A függvény figyelmen kívül hagyja.
$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z	Teljes	A visszaadott RowLastModifiedDateTimeUTC adatok értéke nagyobb vagy egyenlő, mint 2018-02-21T23:18:51.3277273Z