상업용 Marketplace용 보고서 API 가져오기

이 API는 예약된 모든 보고서를 가져옵니다.

요청 구문

메서드	요청 URI
가져오기	https://api.partnercenter.microsoft.com/insights/v1.1/cmp/ScheduledReport?reportId={Report ID}&reportName={Report Name}&queryId={Query ID}

요청 헤더

헤더	형식	설명
권한 부여	문자열	필수. Microsoft Entra 액세스 토큰은 Bearer <token>의 형식으로
콘텐츠 유형 (Content-Type)	문자열	Application/JSON

Path 매개 변수

없음

Query 매개 변수

매개 변수 이름	필수	형식	설명
reportId	아니요	문자열	필터링하여 이 인수에 지정된 reportId 있는 보고서만 세부 정보를 가져옵니다. 여러 reportId 세미콜론(;)으로 구분하여 지정할 수 있습니다.
reportName	아니요	문자열	필터를 사용하여 이 인수에 지정된 reportName 있는 보고서만 세부 정보를 가져옵니다.
queryId	아니요	부울	응답에 미리 정의된 시스템 쿼리 포함

용어집

없음

응답

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

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

응답 페이로드:

{
  "Value": [
    {
      "ReportId": "string",
      "ReportName": "string",
      "Description": "string",
      "QueryId": "string",
      "Query": "string",
      "User": "string",
      "CreatedTime": "string",
      "ModifiedTime": "string",
      "StartTime": "string",
      "ReportStatus": "string",
      "RecurrenceInterval": 0,
      " RecurrenceCount": 0,
      "CallbackUrl": "string",
      "Format": "string"
    }
  ],
  "TotalCount": 0,
  "Message": "string",
  "StatusCode": 0
}

용어집

이 표에는 응답에 있는 요소의 주요 정의가 나열되어 있습니다.

매개 변수	묘사
ReportId	만든 보고서의 UUID(범용 고유 식별자)
ReportName	보고서를 만드는 동안 요청 페이로드에 제공된 이름
Description	보고서를 만드는 동안 요청 페이로드에 제공된 설명
QueryId	보고서를 만드는 동안 요청 페이로드에 제공된 쿼리 ID
Query	이 보고서에 대해 실행될 쿼리 텍스트
User	보고서를 만드는 데 사용되는 사용자 ID
CreatedTime	보고서가 생성된 UTC 시간은 yyyy-MM-ddTHH:mm:ssZ 형식입니다.
ModifiedTime	보고서가 마지막으로 수정된 UTC 시간: yyyy-MM-ddTHH:mm:ssZ
ExecuteNow	보고서를 만드는 동안 요청 페이로드에 제공된 ExecuteNow 매개 변수
queryStartTime	보고서를 만드는 동안 요청 페이로드에 제공된 쿼리 시작 시간입니다. 이는 ExecuteNow "True"로 설정된 경우에만 적용됩니다.
queryEndTime	보고서를 만드는 동안 요청 페이로드에 제공된 쿼리 종료 시간입니다. 이는 ExecuteNow "True"로 설정된 경우에만 적용됩니다.
StartTime	보고서를 만드는 동안 요청 페이로드에 제공된 시작 시간
ReportStatus	보고서 실행의 상태입니다. 가능한 값은 일시 중지됨, 활성, 및 비활성입니다.
RecurrenceInterval	보고서를 만드는 동안 요청 페이로드에 제공된 되풀이 간격
RecurrenceCount	보고서의 나머지 되풀이 횟수
CallbackUrl	보고서를 만드는 동안 요청 페이로드에 제공된 콜백 URL
CallbackMethod	보고서를 만드는 동안 요청 페이로드에 제공된 콜백 메서드
Format	보고서를 만드는 동안 요청 페이로드에 제공된 보고서 파일의 형식
EndTime	보고서를 만드는 동안 요청 페이로드에 제공된 종료 시간입니다. 이는 ExecuteNow "True"로 설정된 경우에만 적용됩니다.
TotalRecurrenceCount	보고서 생성 시 요청 페이로드에 제공된 RecurrenceCount
nextExecutionStartTime	다음 보고서 실행이 시작되는 UTC 타임스탬프
TotalCount	값 배열의 레코드 수
StatusCode	결과 코드입니다. 가능한 값은 200, 400, 401, 403, 500입니다.
message	API 실행의 상태 메시지