Graph API를 사용하여 Intune 보고서 내보내기

아티클
03/28/2024

Intune 보고 인프라로 마이그레이션된 모든 보고서는 단일 최상위 내보내기 API에서 내보낼 수 있습니다. MICROSOFT Graph API 사용하여 HTTP를 호출해야 합니다. Microsoft Graph는 Microsoft 클라우드 서비스 리소스에 액세스할 수 있는 RESTful 웹 API입니다.

참고

Microsoft Graph와 상호 작용하는 도구를 포함하여 REST API 호출에 대한 자세한 내용은 Microsoft Graph API 사용을 참조하세요.

Microsoft Intune 다음 Microsoft Graph API 엔드포인트를 사용하여 보고서를 내보냅니다.

https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs

예제 디바이스는 요청 및 응답을 보고합니다.

요청을 수행할 때 내보내려는 보고서에 따라 요청 본문의 일부로 매개 변수를 제공해야 reportName 합니다. 다음은 디바이스 보고서에 대한 내보내기 요청의 예입니다. 요청에 POST HTTP 메서드를 사용해야 합니다. POST 메서드는 새 리소스를 만들거나 작업을 수행하는 데 사용됩니다.

요청 예제

아래 요청에는 Microsoft Graph 요청에 사용되는 HTTP 메서드가 포함되어 있습니다.

{ 
    "reportName": "Devices", 
    "filter":"(OwnerType eq '1')", 
    "localizationType": "LocalizedValuesAsAdditionalColumn", 
    "format": "json",
    "select": [ 
        "DeviceName", 
        "managementAgent", 
        "ownerType", 
        "complianceState", 
        "OS", 
        "OSVersion", 
        "LastContact", 
        "UPN", 
        "DeviceId" 
    ]
}

참고

데이터를 검색하려면 위의 예제에 지정된 열과 같은 특정 열을 선택합니다. 보고서 내보내기의 기본 열을 중심으로 자동화를 빌드하지 마세요. 관련 열을 명시적으로 선택하려면 자동화를 빌드해야 합니다.

응답 예제

위의 POST 요청에 따라 Graph는 응답 메시지를 반환합니다. 응답 메시지는 요청한 데이터 또는 작업의 결과입니다.

{ 
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#deviceManagement/reports/exportJobs/$entity", 
    "id": "Devices_05e62361-783b-4cec-b635-0aed0ecf14a3", 
    "reportName": "Devices", 
    "filter":"(OwnerType eq '1')", 
    "localizationType": "LocalizedValuesAsAdditionalColumn", 
    "select": [ 
        "DeviceName", 
        "managementAgent", 
        "ownerType", 
        "complianceState", 
        "OS", 
        "OSVersion", 
        "LastContact", 
        "UPN", 
        "DeviceId" 
    ], 
    "format": "csv", 
    "snapshotId": null, 
    "status": "notStarted", 
    "url": null, 
    "requestDateTime": "2020-08-19T03:43:32.1405758Z", 
    "expirationDateTime": "0001-01-01T00:00:00Z" 
}

그런 다음, 필드를 사용하여 id GET 요청을 사용하여 내보내기의 상태를 쿼리할 수 있습니다.

예: https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs('Devices_05e62361-783b-4cec-b635-0aed0ecf14a3')

특성으로 응답을 status: completed 받을 때까지 이 URL을 계속 호출해야 합니다. 다음 예제와 같습니다.

{ 
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#deviceManagement/reports/exportJobs/$entity", 
    "id": "Devices_05e62361-783b-4cec-b635-0aed0ecf14a3", 
    "reportName": "Devices", 
    "filter":"(OwnerType eq '1')", 
    "localizationType": "LocalizedValuesAsAdditionalColumn", 
    "select": [ 
        "DeviceName", 
        "managementAgent", 
        "ownerType", 
        "complianceState", 
        "OS", 
        "OSVersion", 
        "LastContact", 
        "UPN", 
        "DeviceId" 
    ], 
    "format": "csv", 
    "snapshotId": null, 
    "status": "completed", 
    "url": "https://amsua0702repexpstorage.blob.core.windows.net/cec055a4-97f0-4889-b790-dc7ad0d12c29/Devices_05e62361-783b-4cec-b635-0aed0ecf14a3.zip?sv=2019-02-02&sr=b&sig=%2BP%2B4gGiZf0YzlQRuAV5Ji9Beorg4nnOtP%2F7bbFGH7GY%3D&skoid=1db6df02-4c8b-4cb3-8394-7ac2390642f8&sktid=72f988bf-86f1-41af-91ab-2d7cd011db47&skt=2020-08-19T03%3A48%3A32Z&ske=2020-08-19T09%3A44%3A23Z&sks=b&skv=2019-02-02&se=2020-08-19T09%3A44%3A23Z&sp=r", 
    "requestDateTime": "2020-08-19T03:43:32.1405758Z", 
    "expirationDateTime": "2020-08-19T09:44:23.8540289Z" 
}

그런 다음, 필드에서 압축된 CSV를 직접 다운로드할 url 수 있습니다.

보고서 매개 변수

내보내기 요청을 정의하기 위해 요청 본문에 제출할 수 있는 5가지 주요 매개 변수가 있습니다.

reportName:필수. 이 매개 변수는 지정하려는 보고서의 이름입니다.
filter: 대부분의 보고서에는 필요하지 않습니다. 필터 매개 변수는 문자열입니다.
select: 필요하지 않습니다. 보고서에서 원하는 열을 지정합니다. 호출하는 보고서와 관련된 유효한 열 이름만 수락됩니다.
format: 필요하지 않습니다. 기본적으로 데이터는 형식으로 출력됩니다 csv . JSON 형식으로 파일을 출력하려면 를 지정 json 합니다.
localizationType: 이 매개 변수는 보고서의 지역화 동작을 제어합니다. 가능한 값은 및 ReplaceLocalizableValues입니다LocalizedValuesAsAdditionalColumn.

지역화 동작

매개 변수는 localizationType 보고서의 지역화 동작을 제어합니다. 이 매개 변수에 사용할 수 있는 값은 및 ReplaceLocalizableValues입니다LocalizedValuesAsAdditionalColumn.

LocalizedValuesAsAdditionalColumn 보고서 값

매개 변수에 localizationType 대한 이 값은 기본값입니다. 매개 변수를 지정하지 않으면 localizationType 자동으로 삽입됩니다. 이 값은 Intune 지역화 가능한 각 열에 대해 두 개의 열을 제공되도록 지정합니다.

열거형 값: 열거형 값 열에는 로캘에 관계없이 변경되지 않는 원시 문자열 또는 숫자 집합이 포함됩니다. 이 열은 원래 열 이름 아래에 있습니다(예제 참조).
지역화된 문자열 값: 이 열은 _loc 추가된 원래 열 이름이 됩니다. 사람이 읽을 수 있는 문자열 값과 조건부 로캘이 포함됩니다(예제 참조).

예시

OS	OS_loc
1	Windows
1	Windows
1	Windows
2	iOS
3	Android
4	Mac

ReplaceLocalizableValues 보고서 값

ReplaceLocalizableValues 보고서 값은 지역화된 특성당 하나의 열만 반환합니다. 이 열에는 지역화된 값이 있는 원래 열 이름이 포함됩니다.

예시

OS
Windows
Windows
Windows
iOS
Android
Mac

지역화된 값이 없는 열의 경우 실제 열 이름과 실제 열 값이 있는 단일 열만 반환됩니다.

중요

localizationType 매개 변수는 몇 가지 예외를 제외하고 Intune 보고 인프라에서 호스트하는 모든 내보내기 환경과 관련이 있습니다. 및 DevicesWithInventory 보고서 형식은Devices 레거시 호환성 요구 사항으로 인해 매개 변수를 준수하지 localizationType 않습니다.