특정 역할 기반 액세스 제어 및 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 데이터 웨어하우스 리소스에 대한 액세스 권한을 부여함으로써 더 많은 사용자에게 Intune 액세스 권한을 제공합니다.
API를 포함한 Intune 데이터 웨어하우스에 액세스하기 위한 요구 사항은 다음과 같습니다.
- 사용자에게 다음 역할 중 하나 이상이 있어야 합니다.
- 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에서 아래 표에 제공된 세부 정보에 따라 , {entity-collection}를 {api-version} 바꿉니다{location}.
URL에는 다음 요소가 포함됩니다.
| 요소 | 예제 | 설명 |
|---|---|---|
| 위치 | MSUA06 | 기본 URL은 Microsoft Intune 관리 센터에서 Data Warehouse API 블레이드를 확인하여 찾을 수 있습니다. |
| 엔터티 컬렉션 | devicePropertyHistories | OData 엔터티 컬렉션의 이름입니다. 데이터 모델의 컬렉션 및 엔터티에 대한 자세한 내용은 데이터 모델을 참조하십시오. |
| api-version | 베타 | Version은 액세스할 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 쿼리 옵션
현재 버전에서는 , , $select$skip, 및 $topOData 쿼리 매개 변수$filter를 지원합니다. 에서 $filter열이 적용 가능하고 다른 속성이 잘못된 요청을 트리거할 때만 DateKey 지원되거나 RowLastModifiedDateTimeUTC 지원될 수 있습니다.
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 |