Graph API를 사용하여 Intune 보고서 내보내기Export Intune reports using Graph APIs

Intune 보고 인프라로 마이그레이션된 모든 보고서는 단일 최상위 내보내기 API에서 내보낼 수 있습니다.All reports that have been migrated to the Intune reporting infrastructure will be available for export from a single top-level export API. Microsoft Graph API를 사용하여 HTTP 호출을 수행해야 합니다.You must use the Microsoft Graph API to make the HTTP call. Microsoft Graph는 Microsoft 클라우드 서비스 리소스에 액세스할 수 있도록 하는 RESTful 웹 API입니다.Microsoft Graph is a RESTful web API that enables you to access Microsoft Cloud service resources.

참고

Microsoft Graph와 상호 작용하는 도구를 포함하여 REST API를 호출하는 방법에 대한 자세한 내용은 Microsoft Graph API 사용을 참조하세요.For information about making REST API calls, including tools for interacting with Microsoft Graph, see Use the Microsoft Graph API.

Microsoft Endpoint Manager는 다음 Microsoft Graph API 엔드포인트를 사용해 보고서를 내보냅니다.Microsoft Endpoint Manager will export reports using the following Microsoft Graph API endpoint:

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

예제 디바이스 보고서 요청 및 응답Example devices report request and response

요청을 만들 때 내보내려는 보고서를 기반으로 하는 요청 본문의 일부로 reportName 매개 변수를 제공해야 합니다.When making the request, you must provide a reportName parameter as part of the request body based on the report that you would like to export. 다음은 디바이스 보고서에 대한 내보내기 요청의 예제입니다.Below is an example of an export request for the Devices report. 요청에 POST HTTP 메서드를 사용해야 합니다.You must use the POST HTTP method on your request. POST 메서드는 새 리소스를 만들거나 동작을 수행하는 데 사용됩니다.The POST method is used to create a new resource or perform an action.

요청 예제Request example

아래 요청은 Microsoft Graph 요청에 사용되는 HTTP 메서드를 포함합니다.The below request contains the HTTP method used on the request to Microsoft Graph.

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

참고

데이터를 검색하려면 위의 예제에 지정된 것과 같이 특정 열을 선택합니다.To retrieve data, select specific columns, such as those specified in the above example. 보고서 내보내기의 기본 열을 기반으로 자동화를 빌드해서는 안 됩니다.Do not build automation around default columns of any report export. 명시적으로 선택된 관련 열을 기반으로 자동화를 빌드해야 합니다.You should build your automation to explicitly select relevant columns.

응답 예제Response example

위의 POST 요청에 따라 Graph는 응답 메시지를 반환합니다.Based on the above POST request, Graph returns a response message. 응답 메시지는 요청한 데이터 또는 작업의 결과입니다.The response message is the data that you requested or the result of the operation.

{ 
    "@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 요청으로 내보내기의 상태를 쿼리할 수 있습니다.You can then use the id field to query the status of the export with a GET request:

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

status: completed 특성이 포함된 응답을 받을 때까지 이 URL을 계속 호출해야 합니다.You will need to continue calling this URL until you get a response with a status: completed attribute. 응답은 다음 예제와 같이 표시됩니다.It will look like the following example:

{ 
    "@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" 
} 

그런 다음 url 필드에서 압축된 CSV를 직접 다운로드할 수 있습니다.You can then directly download the compressed CSV from the url field.

보고서 매개 변수Report parameters

내보내기 요청을 정의하기 위해 요청 본문에 제출할 수 있는 네 가지 주요 매개 변수가 있습니다.There are four main parameters you can submit in your request body to define the export request:

  • reportName: 필수 사항입니다.reportName: Required. 이 매개 변수는 지정하려는 보고서의 이름입니다.This parameter is the name of the report you want to specify.
  • filter: 대부분의 보고서에는 필요하지 않습니다.filter: Not required for most reports. 필터 매개 변수는 문자열입니다.Note that the filter parameter is a string.
  • select: 필수 아님.select: Not required. 원하는 보고서에서 열을 지정합니다.Specify which columns from the report you want. 호출하는 보고서와 관련된 유효한 열 이름만 허용됩니다.Only valid column names relevant to the report you are calling will be accepted.
  • localizationType: 이 매개 변수는 보고서에 대한 지역화 동작을 제어합니다.localizationType: This parameter controls localization behavior for the report. 가능한 값은 LocalizedValuesAsAdditionalColumnReplaceLocalizableValues입니다.Possible values are LocalizedValuesAsAdditionalColumn and ReplaceLocalizableValues.

지역화 동작Localization behavior

localizationType 매개 변수는 보고서에 대한 지역화 동작을 제어합니다.The localizationType parameter controls localization behavior for the report. 이 매개 변수에 사용할 수 있는 값은 LocalizedValuesAsAdditionalColumnReplaceLocalizableValues입니다.The possible values for this parameter are LocalizedValuesAsAdditionalColumn and ReplaceLocalizableValues.

LocalizedValuesAsAdditionalColumn 보고서 값LocalizedValuesAsAdditionalColumn report value

localizationType 매개 변수에 대한 이 값은 기본값입니다.This value for the localizationType parameter is the default value. localizationType 매개 변수가 지정되지 않은 경우 자동으로 삽입됩니다.It will be inserted automatically if the localizationType parameter is not specified. 이 값은 Intune이 지역화가 가능한 각 열에 대해 두 개의 열을 제공하도록 지정합니다.This value specifies that Intune provides two columns for each localizable column.

  • 열거형 값: ‘열거형 값’ 열은 원시 문자열 또는 로캘과 관계 없이 변하지 않는 숫자 집합을 포함합니다.enum value: The enum value column contains either a raw string, or a set of numbers that don't change, regardless of locale. 이 열은 원본 열 이름 아래에 있습니다(예제 참조).This column will be under the original column name (see example).
  • 지역화된 문자열 값: 이 열은 이름에 _loc이 추가된 원본 열이 됩니다.localized string value: This column will be the original column name with _loc appended. 이 열에는 사람이 읽을 수 있는 로캘 조건부 문자열 값이 포함됩니다(예제 참조).It will contain string values that are human readable, and locale conditional (see example).

예제Example

OSOS OS_locOS_loc
11 WindowsWindows
11 WindowsWindows
11 WindowsWindows
22 iOSiOS
33 AndroidAndroid
44 MacMac

ReplaceLocalizableValues 보고서 값ReplaceLocalizableValues report value

ReplaceLocalizableValues 보고서 값은 지역화된 특성마다 하나의 열만 반환합니다.ReplaceLocalizableValues report value will only return one column per localized attribute. 이 열에는 지역화된 값을 가진 원본 열 이름이 포함됩니다.This column will contain the original column name with the localized values.

예제Example

OSOS
WindowsWindows
WindowsWindows
WindowsWindows
iOSiOS
AndroidAndroid
MacMac

지역화된 값이 없는 열의 경우, true인 열 이름과 true인 열 값을 가진 단 하나의 열만 반환됩니다.For columns without localized values, only a single column with the true column name and the true column values are returned.

중요

localizationType 매개 변수는 몇 가지 예외를 제외하고 Intune의 보고 인프라에서 호스팅하는 모든 내보내기 환경과 관련이 있습니다.The localizationType parameter is relevant for any export experience hosted by Intune's reporting infrastructure with a few exceptions. DevicesDevicesWithInventory 보고서 유형은 레거시 호환성 요구 사항으로 인해 localizationType 매개 변수를 고려하지 않습니다.TheDevices and DevicesWithInventory report types will not honor the localizationType parameter due to legacy compatibility requirements.

다음 단계Next steps