Microsoft Intune Data Warehouse API

  • Článek

Rozhraní Intune Data Warehouse API umožňuje přistupovat k datům Intune ve strojově čitelném formátu pro použití v oblíbeném analytickém nástroji. Pomocí rozhraní API můžete vytvářet sestavy, které poskytují přehled o vašem podnikovém mobilním prostředí. Rozhraní API používá protokol OData, který se řídí standardními vzory pro:

  • Hlavičky požadavků a odpovědí
  • Stavové kódy
  • Metody HTTP
  • Konvence adres URL
  • Typy médií
  • Formáty datových částí
  • Možnosti dotazu

OData (Open Data Protocol) je standard OASIS (Organization for the Advancement of Structured Information Standards), který definuje osvědčený postup pro vytváření a používání rozhraní RESTful API. Data Warehouse Intune používá OData verze 4.0.

Tato referenční část obsahuje přehled koncových bodů, podporovaných metod HTTP, formátů návratové datové části a dokumentaci k datovému modelu Intune Data Warehouse.

Důležité

Nejnovější funkce Data Warehouse můžete vyzkoušet pomocí beta verze. Pokud chcete použít beta verzi, musí adresa URL obsahovat parametr api-version=betadotazu . Beta verze nabízí funkce dříve, než budou obecně dostupné jako podporovaná služba. S tím, jak Intune přidává nové funkce, může beta verze měnit chování a kontrakty dat. Jakýkoli vlastní kód nebo nástroje pro vytváření sestav závislé na beta verzi se můžou s probíhajícími aktualizacemi přerušit.

Vlastní klient OData

K datovému modelu Intune Data Warehouse můžete přistupovat prostřednictvím koncových bodů RESTful. Pokud chcete získat přístup k vašim datům, musí se váš klient autorizovat pomocí Microsoft Entra ID pomocí OAuth 2.0. Nejprve nastavíte webovou aplikaci a klientskou aplikaci v Azure a udělíte klientovi oprávnění. Váš místní klient získá autorizaci a pak může komunikovat s koncovými body Data Warehouse.

Další informace najdete v tématu Získání dat z rozhraní DATA WAREHOUSE API pomocí klienta REST.

Poznámka

Ukázky kódu najdete v úložišti GitHub Intune Data Warehouse na GitHubu.

Interakce s rozhraním API

Rozhraní API vyžaduje autorizaci pomocí Microsoft Entra ID. Microsoft Entra ID používá OAuth 2.0. Po autorizaci můžete získat data z rozhraní API pomocí příkazu HTTP GET a kontaktovat vystavené kolekce entit. Podrobnosti najdete tady:

Datový model Data Warehouse Intune

OData definuje abstraktní datový model a protokol, který umožňuje všem klientům přístup k informacím vystaveným libovolným zdrojem dat. Téma dokumentace k datovému modelu obsahuje vysvětlení oborů názvů, entit a návratových objektů v datovém modelu Intune Data Warehouse. Další informace najdete v tématu Data Warehouse datový model.

Další kroky

Další informace o práci s Microsoft Entra ID najdete v tématu Scénáře ověřování pro Microsoft Entra ID.

Vyhledejte prostředky OData na odata.org.

Přečtěte si o standardu OData verze 4.0 na webu OData verze 4.0.