보고서 쿼리 API 사용해 보기

이 API는 보고서 쿼리 문을 실행합니다. API는 파트너가 데이터를 예상한 대로 확인하는 데 사용할 수 있는 레코드를 100 개만 반환합니다.

Important

이 API의 쿼리 실행 시간 제한은 100초입니다. API가 100초 이상 걸리는 경우 쿼리가 구문적으로 올바르거나 200이 아닌 오류 코드를 수신했을 가능성이 높습니다. 쿼리 구문이 올바르면 실제 보고서 생성이 성공합니다.

요청 구문

메서드	요청 URI
GET	`https://api.partnercenter.microsoft.com/insights/v1/mpn/ScheduledQueries/testQueryResult?<exportQuery={querytext}\\|queryId={queryId}>`

헤더	형식	설명
권한 부여	string	필수입니다. 양식의 Microsoft Entra 액세스 토큰 `Bearer <token>`
콘텐츠-종류	string	`Application/JSON`

None

매개 변수 이름	Type	필수	설명
exportQuery	string	아니요	실행해야 하는 보고서 쿼리 문자열
queryId	string	아니요	유효한 기존 쿼리 ID입니다. exportQuery 매개 변수에 지정된 쿼리 문자열과 함께 사용할 수 없습니다.
startTime	string	아니요	데이터를 원하는 시작 시간입니다. 쿼리에 지정된 시간 간격을 재정의합니다.
endTime 사이에서	string	아니요	데이터를 원하는 종료 시간입니다. 쿼리에 지정된 시간 간격을 재정의합니다.

None

None

응답 페이로드는 다음과 같이 구성됩니다.

응답 코드: 200, 400, 401, 403, 404, 500

응답 페이로드 예제:

Top 100 rows of query execution
{
  "Value": [
    {
    }
  ],
  "TotalCount": 0,
  "Message": "string",
  "StatusCode": 0,
}

이 표는 응답의 주요 요소를 정의합니다.