interfejs API Microsoft Intune Data Warehouse
Interfejs API Intune Data Warehouse umożliwia dostęp do danych Intune w formacie czytelnym dla maszyny do użycia w ulubionym narzędziu analitycznym. Interfejs API umożliwia tworzenie raportów, które zapewniają wgląd w środowisko mobilne przedsiębiorstwa. Interfejs API używa protokołu OData, który jest zgodny ze standardowymi wzorcami dla:
- Nagłówki żądań i odpowiedzi
- Kody stanu
- Metody HTTP
- Konwencje adresów URL
- Typy nośników
- Formaty ładunku
- Opcje zapytania
OData (Open Data Protocol) to standard organizacji na rzecz rozwoju standardów informacji strukturalnych (OASIS), który definiuje najlepsze rozwiązanie w zakresie tworzenia i używania interfejsów API RESTful. Intune Data Warehouse używa OData w wersji 4.0.
Ta sekcja referencyjna zawiera omówienie punktów końcowych, obsługiwanych metod HTTP, formatów zwracanych ładunków i dokumentacji modelu danych Intune Data Warehouse.
Ważna
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.
Klient niestandardowy OData
Dostęp do modelu danych Intune Data Warehouse można uzyskać za pośrednictwem punktów końcowych RESTful. Aby uzyskać dostęp do danych, klient musi autoryzować przy użyciu Tożsamość Microsoft Entra przy użyciu protokołu OAuth 2.0. Najpierw skonfigurujesz aplikację internetową i aplikację kliencką na platformie Azure, udzielasz uprawnień klientowi. Klient lokalny uzyskuje autoryzację, a następnie może komunikować się z punktami końcowymi Data Warehouse.
Aby uzyskać więcej informacji, zobacz Pobieranie danych z interfejsu API Data Warehouse za pomocą klienta REST.
Uwaga
Aby uzyskać przykłady kodu, możesz uzyskać dostęp do repozytorium gitHub Intune Data Warehouse w witrynie Gitub.
Interakcja z interfejsem API
Interfejs API wymaga autoryzacji przy użyciu Tożsamość Microsoft Entra. Tożsamość Microsoft Entra używa protokołu OAuth 2.0. Po autoryzacji możesz pobrać dane z interfejsu API przy użyciu czasownika HTTP GET i skontaktować się z uwidocznionymi kolekcjami jednostek. Aby uzyskać szczegółowe informacje, zobacz:
model danych Intune Data Warehouse
OData definiuje abstrakcyjny model danych i protokół, który umożliwia klientowi dostęp do informacji udostępnianych przez dowolne źródło danych. Temat dokumentacji modelu danych zawiera wyjaśnienie przestrzeni nazw, jednostek i obiektów zwracanych w modelu danych Intune Data Warehouse. Aby uzyskać więcej informacji, zobacz model danych Data Warehouse.
Następne kroki
Dowiedz się więcej o pracy z Tożsamość Microsoft Entra, czytając scenariusze uwierzytelniania dla Tożsamość Microsoft Entra.
Znajdź zasoby OData w odata.org.
Zapoznaj się ze standardem OData w wersji 4.0 w OData w wersji 4.0.