interfejs API Microsoft Intune Data Warehouse

  • Artykuł

Interfejs API Data Warehouse usługi Intune umożliwia dostęp do danych usługi 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. Usługa Intune Data Warehouse używa danych 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 Data Warehouse usługi Intune.

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ż 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.

Klient niestandardowy OData

Dostęp do modelu danych Data Warehouse usługi Intune 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ć dostęp do repozytorium gitHub Intune Data Warehouse w usłudze Gitub, możesz uzyskać dostęp do przykładów kodu.

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 Data Warehouse usługi Intune

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 Data Warehouse usługi Intune. 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.