Intune Data Warehouse API 엔드포인트

특정 역할 기반 액세스 제어 및 Microsoft Entra 자격 증명이 있는 계정에서 Intune Data Warehouse API를 사용할 수 있습니다. 그런 다음 OAuth 2.0을 사용하여 Microsoft Entra ID REST 클라이언트에 권한을 부여합니다. 마지막으로 데이터 웨어하우스 리소스를 호출하는 의미 있는 URL을 형성합니다.

자격 증명 요구 사항 Microsoft Entra ID 및 Intune

인증 및 권한 부여는 Microsoft Entra 자격 증명 및 INTUNE RBAC(역할 기반 액세스 제어)를 기반으로 합니다. 테넌트용 모든 전역 관리자 및 Intune 서비스 관리자는 기본적으로 데이터 웨어하우스에 액세스할 수 있습니다. Intune 역할을 사용하여 Intune 데이터 웨어하우스 리소스에 대한 액세스 권한을 부여하여 더 많은 사용자에게 액세스를 제공합니다.

API를 포함한 Intune 데이터 웨어하우스에 액세스하기 위한 요구 사항은 다음과 같습니다.

• 사용자는 다음 역할 중 하나 이상이어야 합니다.
  • Intune 서비스 관리자
  • Intune 데이터 웨어하우스 리소스에 대한 역할 기반 액세스 권한이 있는 사용자
  • 애플리케이션 전용 인증을 사용하는 사용자 없는 인증

권한 부여

Microsoft Entra ID OAuth 2.0을 사용하여 Microsoft Entra 테넌트에서 웹 애플리케이션 및 웹 API에 대한 액세스 권한을 부여할 수 있습니다. 이 가이드는 언어에 독립적이며 오픈 소스 라이브러리를 사용하지 않고 HTTP 메시지를 보내고 받는 방법을 설명합니다. OAuth 2.0 권한 부여 코드 흐름은 OAuth 2.0 사양의 섹션 4.1 에 설명되어 있습니다.

자세한 내용은 OAuth 2.0 및 Microsoft Entra ID 사용하여 웹 애플리케이션에 대한 액세스 권한 부여를 참조하세요.

API URL 구조

Data Warehouse API 엔드포인트는 각 집합에 대한 엔터티를 읽습니다. API는 GET HTTP 동사와 쿼리 옵션의 하위 집합을 지원합니다.

Intune URL은 다음 형식을 사용합니다.
https://fef.{location}.manage.microsoft.com/ReportingService/DataWarehouseFEService/{entity-collection}?api-version={api-version}

URL에는 다음 요소가 포함됩니다.

API 버전 정보

이제 쿼리 매개 변수 api-version=v1.0를 설정하여 v1.0 버전의 Intune Data Warehouse 사용할 수 있습니다. Data Warehouse 컬렉션에 대한 업데이트 기본적으로 가산적이며 기존 시나리오를 중단하지 않습니다.

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

OData 쿼리 옵션

현재 버전은 , 및 $topOData 쿼리 매개 변수$filter를 $select$skip, 지원합니다. 에서 $filter열이 적용 가능한 경우 또는 RowLastModifiedDateTimeUTC 만 DateKey 지원될 수 있으며 다른 속성은 잘못된 요청을 트리거합니다.

DateKey 범위 필터

DateKey 범위 필터를 사용하여 를 키 속성으로 사용하여 일부 컬렉션에 대해 다운로드할 데이터의 양을 제한할 수 있습니다 dateKey . 필터는 DateKey 다음 $filter 쿼리 매개 변수를 제공하여 서비스 성능을 최적화하는 데 사용할 수 있습니다.

1. DateKey 에서 $filter만 연산자를 lt/le/eq/ge/gt 지원하고 논리 연산 and자와 조인하여 시작 날짜 및/또는 종료 날짜에 매핑할 수 있습니다.
2. maxhistorydays 는 사용자 지정 쿼리 옵션으로 제공됩니다.
   

필터 예제