Microsoft Intune Data Warehouse API

  • Cikk

Az Intune Data Warehouse API-val géppel olvasható formátumban érheti el az Intune-adatokat, és használhatja kedvenc elemzőeszközét. Az API-val jelentéseket készíthet, amelyek betekintést nyújtanak a vállalati mobilkörnyezetbe. Az API az OData protokollt használja, amely a következő szabványos mintákat követi:

  • Kérelem- és válaszfejlécek
  • Állapotkódok
  • HTTP-metódusok
  • URL-konvenciók
  • Médiatípusok
  • Hasznosadat-formátumok
  • Lekérdezési beállítások

Az OData (Open Data Protocol) egy szervezet a Structured Information Standards (OASIS) szabvány fejlesztéséért, amely meghatározza a RESTful API-k létrehozásának és felhasználásának ajánlott eljárásait. Az Intune Data Warehouse az OData 4.0-s verzióját használja.

Ez a referenciaszakasz áttekintést nyújt a végpontokról, a támogatott HTTP-metódusokról, a hasznosadat-formátumokról, valamint az Intune Data Warehouse adatmodell dokumentációját.

Fontos

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 egyéni ügyfél

Az Intune Data Warehouse adatmodellt RESTful-végpontokon keresztül érheti el. Az adatokhoz való hozzáféréshez az ügyfélnek engedélyeznie kell Microsoft Entra ID az OAuth 2.0 használatával. Először beállít egy webalkalmazást és egy ügyfélalkalmazást az Azure-ban, és engedélyeket ad az ügyfélnek. A helyi ügyfél megkapja az engedélyezést, majd kommunikálhat a Data Warehouse végpontokkal.

További információ: Adatok lekérése a Data Warehouse API-ból REST-ügyféllel.

Megjegyzés:

A GitHub Intune-Data Warehouse-adattárat a GitHubon érheti el kódmintákért.

Az API kezelése

Az API hitelesítést igényel Microsoft Entra ID. Microsoft Entra ID az OAuth 2.0-t használja. Az engedélyezést követően egy HTTP GET paranccsal és a közzétett entitásgyűjteményekkel való kapcsolatfelvétellel kérhet le adatokat az API-ból. További részletek:

Intune Data Warehouse adatmodell

Az OData egy absztrakt adatmodellt és egy protokollt határoz meg, amely lehetővé teszi, hogy az ügyfelek hozzáférjenek az adatforrások által közzétett információkhoz. Az adatmodell dokumentációs témaköre az Intune Data Warehouse adatmodellben található névterek, entitások és visszatérési objektumok magyarázatát tartalmazza. További információ: Data Warehouse adatmodell.

Következő lépések

A Microsoft Entra ID a Microsoft Entra ID hitelesítési forgatókönyveit ismertető cikkben olvashat bővebben.

OData-erőforrásokat a odata.org talál.

Tekintse át az OData 4.0-s verzióját ismertető szabványt az OData 4.0-s verziójában.