Microsoft Intune Data Warehouse API

  • 아티클

Intune Data Warehouse API를 사용하면 즐겨 찾는 분석 도구에서 사용하기 위해 머신에서 읽을 수 있는 형식으로 Intune 데이터에 액세스할 수 있습니다. API를 사용하여 엔터프라이즈 모바일 환경에 대한 인사이트를 제공하는 보고서를 작성할 수 있습니다. API는 다음에 대한 표준 패턴을 따르는 OData 프로토콜을 사용합니다.

  • 요청 및 응답 헤더
  • 상태 코드
  • HTTP 메서드
  • URL 규칙
  • 미디어 유형
  • 페이로드 형식
  • 쿼리 옵션

OData(Open Data Protocol)는 RESTful API를 빌드하고 사용하는 모범 사례를 정의하는 OASIS(구조적 정보 표준) 표준을 발전시키기 위한 조직입니다. Intune Data Warehouse OData 버전 4.0을 사용합니다.

이 참조 섹션에서는 엔드포인트의 개요, 지원되는 HTTP 메서드, 반환 페이로드 형식 및 Intune Data Warehouse 데이터 모델에 대한 설명서를 제공합니다.

중요

베타 버전을 사용하여 Data Warehouse 최신 기능을 사용해 볼 수 있습니다. 베타 버전을 사용하려면 URL에 쿼리 매개 변수 api-version=beta가 포함되어야 합니다. 베타 버전은 지원되는 서비스로 일반 공급되기 전에 기능을 제공합니다. Intune에서 새 기능을 추가하면 베타 버전이 동작 및 데이터 계약을 변경할 수 있습니다. 베타 버전에 종속된 사용자 지정 코드 또는 보고 도구는 지속적인 업데이트로 중단될 수 있습니다.

OData 사용자 지정 클라이언트

RESTful 엔드포인트를 통해 Intune Data Warehouse 데이터 모델에 액세스할 수 있습니다. 데이터에 액세스하려면 클라이언트가 OAuth 2.0을 사용하여 Microsoft Entra ID 권한을 부여해야 합니다. 먼저 Azure에서 웹앱 및 클라이언트 앱을 설정하고 클라이언트에 권한을 부여합니다. 로컬 클라이언트는 권한 부여를 받고 Data Warehouse 엔드포인트와 통신할 수 있습니다.

자세한 내용은 REST 클라이언트를 사용하여 Data Warehouse API에서 데이터 가져오기를 참조하세요.

참고

코드 샘플에 대한 GitHub Intune Data Warehouse 리포지토리에 액세스할 수 있습니다.

API와 상호 작용

API에는 Microsoft Entra ID 권한 부여가 필요합니다. Microsoft Entra ID OAuth 2.0을 사용합니다. 권한이 부여되면 HTTP GET 동사를 사용하여 API에서 데이터를 가져와 노출된 엔터티 컬렉션에 연결할 수 있습니다. 자세한 내용은 다음을 참조하세요.

Intune Data Warehouse 데이터 모델

OData는 모든 클라이언트가 데이터 원본에 의해 노출되는 정보에 액세스할 수 있도록 하는 추상 데이터 모델 및 프로토콜을 정의합니다. 데이터 모델 설명서 항목에는 Intune Data Warehouse 데이터 모델의 네임스페이스, 엔터티 및 반환 개체에 대한 설명이 포함되어 있습니다. 자세한 내용은 데이터 모델 Data Warehouse 참조하세요.

다음 단계

Microsoft Entra ID 인증 시나리오를 참조하여 Microsoft Entra ID 작업에 대해 자세히 알아보세요.

odata.org OData 리소스를 찾습니다.

OData 버전 4.0에서 OData 버전 4.0 표준을 검토합니다.