Koncový bod rozhraní INTUNE DATA WAREHOUSE API

Článek
11/19/2024

Rozhraní API Intune Data Warehouse 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 Microsoft Entra ID. Nakonec vytvoříte smysluplnou adresu URL pro volání prostředku datového skladu.

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

Ověřování a autorizace jsou založené na přihlašovacích údajích Microsoft Entra a Intune řízení přístupu na základě role (RBAC). 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í Intune rolí můžete poskytnout přístup více uživatelům tím, že jim udělíte přístup k prostředku Intune datového skladu.

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

Uživatel musí mít minimálně jednu z následujících rolí:
- Správce služby Intune
- Uživatel s přístupem na základě role k prostředku Intune datového skladu
- 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 Intune roli a měl k Intune Data Warehouse přístup, 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.

Oprávnění

Microsoft Entra ID pomocí OAuth 2.0 můžete autorizovat přístup k webovým aplikacím a webovým rozhraním API ve vašem 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 Microsoft Entra ID.

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:

Element	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 v1.0 Intune Data Warehouse 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. Jak Intune přidává nové funkce, beta verze může změ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ů

Poznámka

Příklady filtrů předpokládají, že dnes je 21. 2. 2018.

Filtr	Optimalizace výkonu	Popis
`maxhistorydays=7`	Plný	Vrátí data mezi `DateKey` 20180214 a 20180221.
`$filter=DateKey eq 20180214`	Plný	Vrátí data se `DateKey` rovná 20180214.
`$filter=DateKey ge 20180214 and DateKey lt 20180221`	Plný	Vrátí data mezi `DateKey` 20180214 a 20180220.
`maxhistorydays=7&$filter=DateKey eq 20180214`	Plný	Vrátí data se `DateKey` rovná 20180214. `maxhistorydays` se ignoruje.
`$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z`	Plný	Vrácená data s `RowLastModifiedDateTimeUTC` hodnotou větší nebo rovnou `2018-02-21T23:18:51.3277273Z`

Sdílet prostřednictvím