Punkt końcowy interfejsu API Data Warehouse usługi Intune

Artykuł
12/21/2023

Interfejs API Data Warehouse usługi Intune można używać z kontem z określonymi kontrolkami dostępu opartymi na rolach i poświadczeniami Microsoft Entra. Następnie autoryzujesz klienta REST przy użyciu identyfikatora Microsoft Entra przy użyciu protokołu OAuth 2.0. Na koniec utworzysz zrozumiały adres URL, aby wywołać zasób magazynu danych.

wymagania dotyczące identyfikatora Microsoft Entra i poświadczeń usługi Intune

Uwierzytelnianie i autoryzacja są oparte na poświadczeniach Microsoft Entra i kontroli dostępu opartej na rolach (RBAC) usługi Intune. Wszyscy administratorzy globalni i administratorzy usługi Intune dla dzierżawy mają domyślnie dostęp do magazynu danych. Użyj ról usługi Intune, aby zapewnić dostęp większej liczby użytkowników, dając im dostęp do zasobu magazynu danych usługi Intune .

Wymagania dotyczące uzyskiwania dostępu do Data Warehouse usługi Intune (w tym interfejsu API) to:

Użytkownik musi być jednym z następujących elementów:
- administrator globalny Microsoft Entra
- Administrator usługi Intune
- Użytkownik z dostępem opartym na rolach do zasobu magazynu danych usługi Intune
- Uwierzytelnianie bez użytkowników przy użyciu uwierzytelniania tylko dla aplikacji

Ważna

Aby mieć przypisaną rolę usługi Intune i uzyskać dostęp do Data Warehouse usługi Intune, użytkownik musi mieć licencję usługi Intune. Aby uzyskać więcej informacji, zobacz Kontrola dostępu oparta na rolach (RBAC) z licencjami Microsoft Intune i Microsoft Intune.

Autoryzacji

Microsoft Entra identyfikator używa protokołu OAuth 2.0, aby umożliwić autoryzację dostępu do aplikacji internetowych i internetowych interfejsów API w dzierżawie Microsoft Entra. Ten przewodnik jest niezależny od języka i opisuje sposób wysyłania i odbierania komunikatów HTTP bez korzystania z bibliotek open source. Przepływ kodu autoryzacji OAuth 2.0 został opisany w sekcji 4.1 specyfikacji OAuth 2.0.

Aby uzyskać więcej informacji, zobacz Autoryzowanie dostępu do aplikacji internetowych przy użyciu protokołu OAuth 2.0 i identyfikatora Microsoft Entra.

Struktura adresu URL interfejsu API

Punkty końcowe interfejsu API Data Warehouse odczytują jednostki dla każdego zestawu. Interfejs API obsługuje zlecenie GET HTTP i podzbiór opcji zapytania.

Adres URL usługi Intune ma następujący format:
https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

Uwaga

W powyższym adresie URL zastąp {location}ciąg , {entity-collection}i {api-version} na podstawie szczegółów podanych w poniższej tabeli.

Adres URL zawiera następujące elementy:

Element	Przykład	Opis
Lokalizacji	msua06	Podstawowy adres URL można znaleźć, wyświetlając blok interfejsu API Data Warehouse w centrum administracyjnym Microsoft Intune.
kolekcja jednostek	devicePropertyHistories	Nazwa kolekcji jednostek OData. Aby uzyskać więcej informacji na temat kolekcji i jednostek w modelu danych, zobacz Model danych.
wersja interfejsu API	Beta	Wersja to wersja interfejsu API do uzyskania dostępu. Aby uzyskać więcej informacji, zobacz Wersja.
maxhistorydays	7	(Opcjonalnie) Maksymalna liczba dni historii do pobrania. Ten parametr może być dostarczany do dowolnej kolekcji, ale będzie obowiązywał tylko w przypadku kolekcji, które należą `dateKey` do ich właściwości klucza. Aby uzyskać więcej informacji, zobacz Filtry zakresu dateKey .

Informacje o wersji interfejsu API

Teraz możesz użyć wersji 1.0 Data Warehouse usługi Intune, ustawiając parametr api-version=v1.0zapytania . Aktualizacje do kolekcji w Data Warehouse mają charakter addytywny i nie przerywają istniejących scenariuszy.

Najnowszą funkcjonalność Data Warehouse można wypróbować przy użyciu wersji beta. Aby użyć wersji beta, adres URL musi zawierać parametr api-version=betazapytania . Wersja beta oferuje funkcje, zanim zostaną ogólnie udostępnione jako obsługiwana usługa. Ponieważ usługa Intune dodaje nowe funkcje, wersja beta może zmienić zachowanie i kontrakty danych. Wszelkie niestandardowe narzędzia do tworzenia kodu lub raportowania zależne od wersji beta mogą zostać przerwane z bieżącymi aktualizacjami.

Opcje zapytania OData

Bieżąca wersja obsługuje następujące parametry zapytania OData: $filter, $selecti $skip,$top. W $filtersystemie tylko DateKey lub RowLastModifiedDateTimeUTC mogą być obsługiwane, gdy kolumny mają zastosowanie, a inne właściwości wyzwalają nieprawidłowe żądanie.

Filtry zakresu dateKey

DateKey Filtry zakresu mogą służyć do ograniczania ilości danych do pobrania dla niektórych kolekcji z dateKey właściwością klucza. Filtr DateKey może służyć do optymalizacji wydajności usługi przez podanie następującego $filter parametru zapytania:

DateKey sam w systemie $filter, obsługujący lt/le/eq/ge/gt operatory i łączący się z operatorem andlogiki , gdzie można je zamapować na datę rozpoczęcia i/lub datę zakończenia.
maxhistorydays jest dostarczana jako opcja zapytania niestandardowego.

Przykłady filtrów