데스크톱 애플리케이션에서 오류 세부 정보 가져오기Get details for an error in your desktop application

Microsoft Store analytics API에서이 메서드를 사용 하 여 JSON 형식으로 앱에 대 한 특정 오류에 대 한 자세한 데이터를 가져옵니다.Use this method in the Microsoft Store analytics API to get detailed data for a specific error for your app in JSON format. 이 메서드는 지난 30 일 동안 발생 한 오류에 대 한 정보만 검색할 수 있습니다.This method can only retrieve details for errors that occurred in the last 30 days. 자세한 오류 데이터는 파트너 센터의 데스크톱 응용 프로그램에 대 한 상태 보고서 에서도 사용할 수 있습니다.Detailed error data is also available in the Health report for desktop applications in Partner Center.

이 메서드를 사용 하려면 먼저 get error reporting data 메서드를 사용 하 여 자세한 정보를 가져올 오류의 ID를 검색 해야 합니다.Before you can use this method, you must first use the get error reporting data method to retrieve the ID of the error for which you want to get detailed info.

필수 구성 요소Prerequisites

이 방법을 사용 하려면 먼저 다음을 수행 해야 합니다.To use this method, you need to first do the following:

  • 아직 수행 하지 않은 경우 Microsoft Store 분석 API에 대 한 모든 필수 구성 요소 를 완료 합니다.If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • 이 메서드에 대 한 요청 헤더에 사용할 AZURE AD 액세스 토큰을 가져옵니다 .Obtain an Azure AD access token to use in the request header for this method. 액세스 토큰을 얻은 후 만료되기 전에 60분 동안 사용할 수 있습니다.After you obtain an access token, you have 60 minutes to use it before it expires. 토큰이 만료 된 후 새 토큰을 얻을 수 있습니다.After the token expires, you can obtain a new one.
  • 자세한 정보를 가져오려는 오류의 ID를 가져옵니다.Get the ID of the error for which you want to get detailed info. 이 ID를 얻으려면 get error reporting data 메서드를 사용 하 고 해당 메서드의 응답 본문에서 failureHash 값을 사용 합니다.To get this ID, use the get error reporting data method and use the failureHash value in the response body of that method.

요청Request

요청 구문Request syntax

방법Method 요청 URIRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails

요청 헤더Request header

headerHeader 유형Type DescriptionDescription
권한 부여Authorization 문자열string 필수 요소.Required. Bearer <token> 형식의 Azure AD 액세스 토큰입니다.The Azure AD access token in the form Bearer <token>.

요청 매개 변수Request parameters

매개 변수Parameter 형식Type DescriptionDescription 필수Required
applicationIdapplicationId 문자열string 오류 정보를 검색할 데스크톱 응용 프로그램의 제품 ID입니다.The product ID of the desktop application for which you want to retrieve error details. 데스크톱 응용 프로그램의 제품 ID를 얻으려면 파트너 센터 (예: 상태 보고서) 에서 데스크톱 응용 프로그램에 대 한 분석 보고서 를 열고 URL에서 제품 id를 검색 합니다.To get the product ID of a desktop application, open any analytics report for your desktop application in Partner Center (such as the Health report) and retrieve the product ID from the URL. Yes
failureHashfailureHash 문자열string 자세한 정보를 가져올 오류에 대 한 고유 ID입니다.The unique ID of the error for which you want to get detailed info. 관심이 있는 오류에 대 한이 값을 얻으려면 get error reporting data 메서드를 사용 하 고 해당 메서드의 응답 본문에서 failureHash 값을 사용 합니다.To get this value for the error you are interested in, use the get error reporting data method and use the failureHash value in the response body of that method. Yes
startDatestartDate datedate 검색할 자세한 오류 데이터의 날짜 범위에 있는 시작 날짜입니다.The start date in the date range of detailed error data to retrieve. 기본값은 현재 날짜의 30 일입니다.The default is 30 days before the current date.

참고:     이 메서드는 지난 30 일 동안 발생 한 오류에 대 한 정보만 검색할 수 있습니다.Note:  This method can only retrieve details for errors that occurred in the last 30 days.

No
endDateendDate datedate 검색할 자세한 오류 데이터의 날짜 범위에 있는 종료 날짜입니다.The end date in the date range of detailed error data to retrieve. 기본값은 현재 날짜입니다.The default is the current date. No
toptop intint 요청에 반환할 데이터 행 수입니다.The number of rows of data to return in the request. 지정 되지 않은 경우 최대값 및 기본값은 1만입니다.The maximum value and the default value if not specified is 10000. 쿼리에 더 많은 행이 있는 경우 응답 본문에는 다음 데이터 페이지를 요청 하는 데 사용할 수 있는 다음 링크가 포함 됩니다.If there are more rows in the query, the response body includes a next link that you can use to request the next page of data. No
skipskip intint 쿼리에서 건너뛸 행의 수입니다.The number of rows to skip in the query. 이 매개 변수를 사용 하 여 많은 데이터 집합을 페이징 합니다.Use this parameter to page through large data sets. 예를 들어 top = 10 및 skip = 0은 처음 10 개의 데이터 행을 검색 하 고 top = 10 및 skip = 10은 다음 10 개의 데이터 행을 검색 하는 식입니다.For example, top=10 and skip=0 retrieves the first 10 rows of data, top=10 and skip=10 retrieves the next 10 rows of data, and so on. No
filterfilter 문자열string 응답의 행을 필터링 하는 하나 이상의 문입니다.One or more statements that filter the rows in the response. 각 문에는 eq 또는 ne 연산자와 연결 된 응답 본문 및 값의 필드 이름이 포함 되며, and 또는 or를 사용 하 여 문을 결합할 수 있습니다.Each statement contains a field name from the response body and value that are associated with the eq or ne operators, and statements can be combined using and or or. 문자열 값은 필터 매개 변수에서 작은따옴표로 묶어야 합니다.String values must be surrounded by single quotes in the filter parameter. 응답 본문에서 다음 필드를 지정할 수 있습니다.You can specify the following fields from the response body:

  • 시장market
  • datedate
  • cabIdHashcabIdHash
  • cabExpirationTimecabExpirationTime
  • deviceTypedeviceType
  • deviceModeldeviceModel
  • osVersionosVersion
  • osReleaseosRelease
  • applicationVersionapplicationVersion
  • osBuildosBuild
  • 이름도fileName
No
orderbyorderby 문자열string 결과 데이터 값을 정렬 하는 문입니다.A statement that orders the result data values. 구문은 orderby = field [order], field [order],...입니다. Field 매개 변수는 다음 문자열 중 하나일 수 있습니다.The syntax is orderby=field [order],field [order],.... The field parameter can be one of the following strings:
  • 시장market
  • datedate
  • cabIdHashcabIdHash
  • cabExpirationTimecabExpirationTime
  • deviceTypedeviceType
  • deviceModeldeviceModel
  • osVersionosVersion
  • osReleaseosRelease
  • applicationVersionapplicationVersion
  • osBuildosBuild
  • 이름도fileName

Order 매개 변수는 선택 사항이 며 asc 또는 desc 로 각 필드에 대해 오름차순 또는 내림차순을 지정할 수 있습니다.The order parameter is optional, and can be asc or desc to specify ascending or descending order for each field. 기본값은 asc입니다.The default is asc.

다음은 orderby 문자열의 예입니다. orderby = date, marketHere is an example orderby string: orderby=date,market

No

요청 예제Request example

다음 예에서는 자세한 오류 데이터를 가져오는 몇 가지 요청을 보여 줍니다.The following examples demonstrate several requests for getting detailed error data. ApplicationId 값을 데스크톱 응용 프로그램의 제품 ID로 바꿉니다.Replace the applicationId value with the product ID for your desktop application.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&failureHash=012e33e3-dbc9-b12f-c124-9d9810f05d8b&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&failureHash=012e33e3-dbc9-b12f-c124-9d9810f05d8b&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

응답Response

응답 본문Response body

Value 형식Type DescriptionDescription
Value arrayarray 자세한 오류 데이터를 포함 하는 개체의 배열입니다.An array of objects that contain detailed error data. 각 개체의 데이터에 대 한 자세한 내용은 아래의 오류 정보 값 섹션을 참조 하십시오.For more information about the data in each object, see the error detail values section below.
@nextLink 문자열string 추가 데이터 페이지가 있는 경우이 문자열에는 다음 데이터 페이지를 요청 하는 데 사용할 수 있는 URI가 포함 됩니다.If there are additional pages of data, this string contains a URI that you can use to request the next page of data. 예를 들어 요청의 top 매개 변수가 10으로 설정 되어 있지만 해당 쿼리에 대해 10 개 이상의 행이 있는 경우이 값이 반환 됩니다.For example, this value is returned if the top parameter of the request is set to 10 but there are more than 10 rows of errors for the query.
TotalCountTotalCount integerinteger 쿼리의 데이터 결과에 있는 총 행 수입니다.The total number of rows in the data result for the query.

오류 정보 값Error detail values

배열의 요소에는 다음 값이 포함 됩니다.Elements in the Value array contain the following values.

Value 형식Type DescriptionDescription
applicationIdapplicationId 문자열string 오류 정보를 검색 한 데스크톱 응용 프로그램의 제품 ID입니다.The product ID of the desktop application for which you retrieved error details.
failureHashfailureHash 문자열string 오류에 대 한 고유 식별자입니다.The unique identifier for the error.
failureNamefailureName 문자열string 오류 이름으로, 하나 이상의 문제 클래스, 예외/버그 검사 코드, 오류가 발생 한 이미지 이름 및 연결 된 함수 이름을 네 부분으로 구성 되어 있습니다.The name of the failure, which is made up of four parts: one or more problem classes, an exception/bug check code, the name of the image where the failure occurred, and the associated function name.
datedate 문자열string 오류 데이터에 대 한 날짜 범위의 첫 번째 날짜입니다.The first date in the date range for the error data. 요청에서 하루를 지정 하는 경우이 값은 해당 날짜입니다.If the request specified a single day, this value is that date. 요청에서 주, 월 또는 다른 날짜 범위를 지정 하는 경우이 값은 해당 날짜 범위의 첫 번째 날짜입니다.If the request specified a week, month, or other date range, this value is the first date in that date range.
cabIdHashcabIdHash 문자열string 이 오류와 연결 된 CAB 파일의 고유 ID 해시입니다.The unique ID hash of the CAB file that is associated with this error.
cabExpirationTimecabExpirationTime 문자열string CAB 파일이 만료 되어 더 이상 다운로드할 수 없는 날짜 및 시간 (ISO 8601 형식)입니다.The date and time when the CAB file is expired and can no longer be downloaded, in ISO 8601 format.
marketmarket 문자열string 장치 시장의 ISO 3166 국가 코드입니다.The ISO 3166 country code of the device market.
osBuildosBuild 문자열string 오류가 발생 한 OS의 빌드 번호입니다.The build number of the OS on which the error occurred.
applicationVersionapplicationVersion 문자열string 오류가 발생 한 응용 프로그램 실행 파일의 버전입니다.The version of the application executable in which the error occurred.
deviceModeldeviceModel 문자열string 오류가 발생 했을 때 앱이 실행 되는 장치의 모델을 지정 하는 문자열입니다.A string that specifies the model of the device on which the app was running when the error occurred.
osVersionosVersion 문자열string 데스크톱 응용 프로그램이 설치 되는 OS 버전을 지정 하는 다음 문자열 중 하나입니다.One of the following strings that specifies the OS version on which the desktop application is installed:

  • Windows 7Windows 7
  • Windows 8.1Windows 8.1
  • Windows 10Windows 10
  • Windows Server 2016Windows Server 2016
  • Windows Server 1709Windows Server 1709
  • 알 수 없음Unknown
osReleaseosRelease 문자열string 오류가 발생 한 os 릴리스 또는 플 라이팅 링 (os 버전 내의 subpopulation)을 지정 하는 다음 문자열 중 하나입니다.One of the following strings that specifies the OS release or flighting ring (as a subpopulation within OS version) on which the error occurred.

Windows 10의 경우:For Windows 10:

  • 버전 1507Version 1507
  • 버전 1511Version 1511
  • 버전 1607Version 1607
  • 버전 1703Version 1703
  • 버전 1709Version 1709
  • 버전 1803Version 1803
  • 릴리스 미리 보기Release Preview
  • 빠른 참가자Insider Fast
  • 참가자 느림Insider Slow

Windows Server 1709:For Windows Server 1709:

  • 출시RTM

Windows Server 2016:For Windows Server 2016:

  • 버전 1607Version 1607

Windows 8.1의 경우:For Windows 8.1:

  • Update 1Update 1

Windows 7의 경우:For Windows 7:

  • 서비스 팩 1Service Pack 1

OS 릴리스 또는 플 라이팅 링을 알 수 없는 경우이 필드에 알 수 없는값이 있습니다.If the OS release or flighting ring is unknown, this field has the value Unknown.

deviceTypedeviceType 문자열string 오류가 발생 한 장치 유형을 나타내는 다음 문자열 중 하나입니다.One of the following strings that indicates the type of device on which the error occurred:

  • 컴퓨터PC
  • ServerServer
  • 알 수 없음Unknown
cabDownloadable 가능cabDownloadable 부울Boolean 이 사용자에 대해 CAB 파일을 다운로드할 수 있는지 여부를 나타냅니다.Indicates whether the CAB file is downloadable for this user.
fileNamefileName 문자열string 오류 정보를 검색 한 데스크톱 응용 프로그램에 대 한 실행 파일의 이름입니다.The name of the executable file for the desktop application for which you retrieved error details.

응답 예제Response example

다음 예제에서는이 요청에 대 한 예제 JSON 응답 본문을 보여 줍니다.The following example demonstrates an example JSON response body for this request.

{
  "Value": [
    {
      "applicationId": "10238467886765136388",
      "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
      "failureName": "NULL_CLASS_PTR_WRITE_c0000005_contoso.exe!unknown_error_in_process",
      "date": "2018-01-28 23:55:29",
      "cabIdHash": "54ffb83a-e159-41d2-8158-f36f306cc01e",
      "cabExpirationTime": "2018-02-27 23:55:29",
      "market": "US",
      "osBuild": "10.0.10240",
      "applicationVersion": "2.2.2.0",
      "deviceModel": "Contoso All-in-one",
      "osVersion": "Windows 10",
      "osRelease": "Version 1703",
      "deviceType": "PC",
      "cabDownloadable": false,
      "fileName": "contosodemo.exe"
    }
  ],
  "@nextLink": null,
  "TotalCount": 1
}