Koncový bod rozhraní INTUNE Data Warehouse API

Článek
12/21/2023

Rozhraní Intune Data Warehouse API můžete použít s účtem s konkrétními řízeními přístupu na základě role a Microsoft Entra přihlašovacími údaji. Potom pomocí OAuth 2.0 autorizujete klienta REST s ID Microsoft Entra. Nakonec vytvoříte smysluplnou adresu URL pro volání prostředku datového skladu.

Microsoft Entra ID a požadavky na přihlašovací údaje Intune

Ověřování a autorizace jsou založeny na Microsoft Entra přihlašovacích údajích a řízení přístupu na základě role (RBAC) Intune. Všichni globální správci a správci služeb Intune pro vašeho tenanta mají ve výchozím nastavení přístup k datovému skladu. Pomocí rolí Intune můžete poskytnout přístup více uživatelům tím, že jim udělíte přístup k prostředku datového skladu Intune .

Požadavky pro přístup k Data Warehouse Intune (včetně rozhraní API) jsou:

Uživatel musí být jedním z těchto:
- globální správce Microsoft Entra
- Správce služby Intune
- Uživatel s přístupem na základě role k prostředku datového skladu Intune
- Ověřování bez uživatele s využitím ověřování pouze aplikace

Důležité

Aby měl uživatel přiřazenou roli Intune a měl přístup k Data Warehouse Intune, musí mít licenci Intune. Další informace najdete v tématu Řízení přístupu na základě role (RBAC) s Microsoft Intune a licencováním Microsoft Intune.

Autorizace

Microsoft Entra ID používá OAuth 2.0 k autorizaci přístupu k webovým aplikacím a webovým rozhraním API v tenantovi Microsoft Entra. Tato příručka je nezávislá na jazyce a popisuje, jak odesílat a přijímat zprávy HTTP bez použití opensourcových knihoven. Tok autorizačního kódu OAuth 2.0 je popsaný v části 4.1 specifikace OAuth 2.0.

Další informace najdete v tématu Autorizace přístupu k webovým aplikacím pomocí OAuth 2.0 a ID Microsoft Entra.

Struktura adres URL rozhraní API

Koncové body rozhraní API Data Warehouse čtou entity pro každou sadu. Rozhraní API podporuje příkaz GET HTTP a podmnožinu možností dotazu.

Adresa URL pro Intune používá následující formát:
https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

Poznámka

Ve výše uvedené adrese URL nahraďte {location}, {entity-collection}a {api-version} na základě podrobností uvedených v následující tabulce.

Adresa URL obsahuje následující prvky:

Prvek	Příklad	Popis
Umístění	msua06	Základní adresu URL najdete v okně rozhraní DATA WAREHOUSE API v Centru pro správu Microsoft Intune.
kolekce entit	devicePropertyHistories	Název kolekce entit OData. Další informace o kolekcích a entitách v datovém modelu najdete v tématu Datový model.
api-version	Beta	Version je verze rozhraní API, ke které se má přistupovat. Další informace najdete v tématu Verze.
maxhistorydays	7	(Volitelné) Maximální počet dnů historie, která se má načíst. Tento parametr lze zadat do libovolné kolekce, ale projeví se pouze u kolekcí, které zahrnují `dateKey` jako součást vlastnosti klíče. Další informace najdete v tématu Filtry rozsahu DateKey .

Informace o verzi rozhraní API

Teď můžete použít verzi Data Warehouse Intune v1.0 nastavením parametru api-version=v1.0dotazu . Aktualizace do kolekcí v Data Warehouse jsou ze své podstaty doplňkové a nenarušují stávající scénáře.

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.

Možnosti dotazu OData

Aktuální verze podporuje následující parametry dotazu OData: $filter, $select$skip, a $top. V $filternástroji se podporuje pouze DateKey nebo RowLastModifiedDateTimeUTC v případě, že jsou sloupce použitelné a jiné vlastnosti by aktivovaly chybný požadavek.

Filtry rozsahu DateKey

DateKey Filtry rozsahu se dají použít k omezení množství dat, která se mají stáhnout u některých kolekcí s dateKey vlastností klíče. Filtr DateKey lze použít k optimalizaci výkonu služby zadáním následujícího $filter parametru dotazu:

DateKey samotné v nástroji $filter, který podporuje lt/le/eq/ge/gt operátory a spojuje je s logickým operátorem and, kde je možné je namapovat na počáteční nebo koncové datum.
maxhistorydays se poskytuje jako možnost vlastního dotazu.

Příklady filtrů