punkt końcowy interfejsu API Intune Data Warehouse

Możesz użyć interfejsu API Intune Data Warehouse z kontem z określonymi kontrolkami dostępu opartymi na rolach i poświadczeniami Microsoft Entra. Następnie autoryzujesz klienta REST przy użyciu Tożsamość 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 poświadczeń Tożsamość Microsoft Entra i Intune

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

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

• Użytkownik musi mieć co najmniej jedną z następujących ról:
  • Administrator usługi Intune
  • Użytkownik z dostępem opartym na rolach do zasobu magazynu danych Intune
  • Uwierzytelnianie bez użytkowników przy użyciu uwierzytelniania tylko dla aplikacji

Autoryzacja

Tożsamość Microsoft Entra 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 Tożsamość 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 Intune używa następującego formatu:
https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

Adres URL zawiera następujące elementy:

Informacje o wersji interfejsu API

Teraz możesz użyć wersji 1.0 Intune Data Warehouse, 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ż 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:

1. 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.
2. maxhistorydays jest dostarczana jako opcja zapytania niestandardowego.
   

Przykłady filtrów