Sdílet prostřednictvím


Koncový bod rozhraní INTUNE Data Warehouse API

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:

  1. 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.
  2. 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