Koncový bod rozhraní API Intune Data Warehouse

Rozhraní Intune Data Warehouse API můžete používat s účtem se specifickými ovládacími prvky přístupu na základě role a Microsoft Entra přihlašovacích údajů. Pak autorizujete klienta REST s Microsoft Entra ID pomocí OAuth 2.0. A nakonec vytvoříte smysluplnou adresu URL pro volání prostředku datového skladu.

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

Ověřování a autorizace jsou založené na přihlašovacích údajích Microsoft Entra a řízení přístupu na základě role (RBAC) služby Intune. Všichni správci 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 na přístup k Intune Data Warehouse (včetně API) jsou:

  • Uživatel musí mít alespoň jednu z následujících rolí:
    • Správce služby Intune
    • Uživatel s přístupem k prostředku datového skladu Intune na základě role
    • Ověřování bez uživatelů pomocí ověřování jenom aplikací

Důležité

Přiřazení role Intune a přístup k Intune Data Warehouse vyžaduje, aby měl uživatel 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, který vám umožní autorizovat přístup k webovým aplikacím a webovým rozhraním API ve vašem tenantovi služby Microsoft Entra. Tato příručka je jazykově nezávislá 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 adresy 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í dotazů.

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} to na základě podrobností uvedených v tabulce níže.

Adresa URL obsahuje následující prvky:

Prvek Příklad Popis
lokalita msua06 Základní adresu URL najdete tak, že si zobrazíte okno rozhraní API služby Data Warehouse v centru pro správu služby 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.
Verze rozhraní API Beta verze Version je verze rozhraní API, ke kterému se má přistupovat. Další informace najdete v tématu Verze.
maxhistorydays 7 (Volitelné) Maximální počet dnů historie, které se mají načíst. Tento parametr lze zadat do libovolné kolekce, ale projeví se pouze u kolekcí, které jsou součástí dateKey jejich vlastnosti klíče. Další informace najdete v tématu Filtry rozsahů DateKey .

Informace o verzi rozhraní API

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

Nejnovější funkce Data Warehouse si můžete vyzkoušet pomocí beta verze. Pokud chcete používat beta verzi, musí vaše adresa URL obsahovat parametr api-version=betadotazu. Beta verze nabízí funkce předtím, než budou obecně dostupné jako podporovaná služba. Vzhledem k tomu, že Intune přidává nové funkce, může beta verze změnit chování a kontrakty dat. Jakýkoli vlastní kód nebo nástroje pro vytváření sestav, které jsou závislé na beta verzi, se můžou při probíhajících aktualizacích porušit.

Možnosti dotazu OData

Aktuální verze podporuje následující parametry dotazu OData: $filter, $select$skip, a $top. V $filter, DateKey nebo RowLastModifiedDateTimeUTC může být podporováno, když je možné použít sloupce, a jiné vlastnosti by vyvolaly chybný požadavek.

Filtry rozsahu DateKey

DateKey Filtry rozsahu je možné použít k omezení množství dat, která se mají stáhnout pro některé kolekce s dateKey vlastností jako klíčem. Filtr DateKey je možné použít k optimalizaci výkonu služby zadáním následujícího $filter parametru dotazu:

  1. DateKey samostatně v $filter, podporuje operátory lt/le/eq/ge/gt a spojuje se s operátorem andlogiky, kde je lze namapovat na počáteční datum nebo koncové datum.
  2. maxhistorydays se dodává jako možnost vlastního dotazu.

Příklady filtrů

Poznámka

V příkladech filtru se předpokládá, že dnešek je 21. 2. 2018.

Filtrovat Optimalizace výkonu Popis
maxhistorydays=7 Úplná Vrátí data s DateKey hodnotou mezi 20180214 a 20180221.
$filter=DateKey eq 20180214 Úplná Vrátí data, která DateKey se rovnají 20180214.
$filter=DateKey ge 20180214 and DateKey lt 20180221 Úplná Vrátí data s hodnotou DateKey mezi 20180214 a 20180220.
maxhistorydays=7&$filter=DateKey eq 20180214 Úplná Vrátí data, která DateKey se rovnají 20180214. maxhistorydays se ignoruje.
$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z Úplná Vrátit data, která jsou RowLastModifiedDateTimeUTC větší než nebo rovna 2018-02-21T23:18:51.3277273Z
  • Poslední aktualizace v