Intune Data Warehouse API 엔드포인트

아티클
12/21/2023

특정 역할 기반 액세스 제어 및 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 데이터 웨어하우스에 액세스하기 위한 요구 사항은 다음과 같습니다.

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

중요

Intune 역할을 할당하고 Intune Data Warehouse 액세스하려면 사용자에게 Intune 라이선스가 있어야 합니다. 자세한 내용은 Microsoft Intune 및 Microsoft Intune 라이선스를 사용하는 RBAC(역할 기반 액세스 제어)를 참조하세요.

권한 부여

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-version} 을 아래 표에 제공된 세부 정보에 따라 바꿉{location}{entity-collection}니다.

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

요소	예제	설명
위치	msua06	기본 URL은 Microsoft Intune 관리 센터에서 Data Warehouse API 블레이드를 확인하여 찾을 수 있습니다.
entity-collection	devicePropertyHistories	OData 엔터티 컬렉션의 이름입니다. 데이터 모델의 컬렉션 및 엔터티에 대한 자세한 내용은 데이터 모델을 참조하세요.
api-version	Beta	버전은 액세스할 API의 버전입니다. 자세한 내용은 버전을 참조하세요.
maxhistorydays	7	(선택 사항) 검색할 기록의 최대 일 수입니다. 이 매개 변수는 모든 컬렉션에 제공할 수 있지만 키 속성의 일부로 포함된 `dateKey` 컬렉션에만 적용됩니다. 자세한 내용은 DateKey 범위 필터를 참조하세요.

API 버전 정보

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

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

OData 쿼리 옵션

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

DateKey 범위 필터

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

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

필터 예제

참고

필터 예제에서는 오늘이 2018년 2월 21일이라고 가정합니다.

필터	성능 최적화	설명
`maxhistorydays=7`	Full	20180214 및 20180221 사이에 있는 데이터를 `DateKey` 반환합니다.
`$filter=DateKey eq 20180214`	Full	20180214 같은 데이터를 `DateKey` 반환합니다.
`$filter=DateKey ge 20180214 and DateKey lt 20180221`	Full	20180214 및 20180220 사이에 있는 데이터를 `DateKey` 반환합니다.
`maxhistorydays=7&$filter=DateKey eq 20180214`	Full	20180214 같은 데이터를 `DateKey` 반환합니다. `maxhistorydays` 가 무시됩니다.
`$filter=RowLastModifiedDateTimeUTC ge 2018-02-21T23:18:51.3277273Z`	Full	가 있는 `RowLastModifiedDateTimeUTC` 반환 데이터가 보다 크거나 같음 `2018-02-21T23:18:51.3277273Z`