보고서 쿼리 API 사용해 보기

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

중요하다

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

요청 구문

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

머리글	형	묘사
권한 부여	문자열	필수. 양식의 Microsoft Entra 액세스 토큰은 `Bearer <token>`
Content-Type	문자열	`Application/JSON`

없음

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

없음

없음

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

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

응답 페이로드 예제:

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

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

이 페이지가 도움이 되었나요?