ListCallAnalyticsJobs - 변환
요청 구문요청 파라미터응답 구문응답 요소오류참고 항목

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

ListCallAnalyticsJobs

지정된 기준과 일치하는 통화 분석 작업의 목록을 제공합니다. 조건을 지정하지 않으면 모든 통화 분석 작업이 반환됩니다.

특정 Call Analytics 작업에 대한 세부 정보를 보려면GetCallAnalyticsJob 작업을 사용합니다.

요청 구문

{
   "JobNameContains": "string",
   "MaxResults": number,
   "NextToken": "string",
   "Status": "string"
}

요청 파라미터

모든 작업에 공통되는 파라미터에 대한 자세한 내용은 범용 파라미터를 참조하십시오.

요청은 JSON 형식의 다음 데이터를 받습니다.

JobNameContains

지정된 문자열이 포함된 통화 분석 작업만 반환합니다. 검색은 대/소문자를 구분하지 않습니다.

유형: String

길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.

패턴: ^[0-9a-zA-Z._-]+

필수 항목 여부: 아니요

MaxResults

각 결과 페이지에서 반환할 통화 분석 작업의 최대 수입니다. 지정한 값보다 적은 결과가 있는 경우 실제 결과만 반환됩니다. 값을 지정하지 않으면 기본값은 5입니다.

유형: Integer

유효한 범위: 최소값 1. 최대값은 100입니다.

필수 항목 여부: 아니요

NextToken

ListCallAnalyticsJobs요청에서NextToken 반환되는 결과가 표시될 수 있는 것보다 많을 경우 관련 문자열과 함께 응답에 표시됩니다. 다음 페이지의 결과를 가져오려면 이 문자열을 복사하고 복사된 문자열의 값을 포함하여NextToken 요청을 반복하세요. 필요한 만큼 반복하여 모든 결과를 확인합니다.

유형: String

길이 제약: 최대 길이는 8192입니다.

패턴: .+

필수 항목 여부: 아니요

Status

지정된 상태의 통화 분석 작업만 반환합니다. 작업은 생성 날짜순으로 정렬되며, 가장 최근의 작업부터 정렬됩니다. 포함하지Status 않으면 모든 통화 분석 작업이 반환됩니다.

유형: String

유효한 값: QUEUED | IN_PROGRESS | FAILED | COMPLETED

필수 항목 여부: 아니요

응답 구문

{
   "CallAnalyticsJobSummaries": [ 
      { 
         "CallAnalyticsJobName": "string",
         "CallAnalyticsJobStatus": "string",
         "CompletionTime": number,
         "CreationTime": number,
         "FailureReason": "string",
         "LanguageCode": "string",
         "StartTime": number
      }
   ],
   "NextToken": "string",
   "Status": "string"
}

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

CallAnalyticsJobSummaries

각 결과에 대한 정보 요약을 제공합니다.

유형: CallAnalyticsJobSummary 객체 배열

NextToken

응답에NextToken 가 있는 경우 모든 결과가 표시되지 않음을 나타냅니다. 다음 결과 세트를 보려면 결과 출력의NextToken 파라미터와 연결된 문자열을 복사한 다음 복사된 문자열의 값을 포함하여NextToken 요청을 다시 실행합니다. 필요한 만큼 반복하여 모든 결과를 확인합니다.

유형: String

길이 제약: 최대 길이는 8192입니다.

패턴: .+

Status

요청에 지정된 상태의 모든 통화 분석 작업을 나열합니다. 작업은 생성 날짜순으로 정렬되며, 가장 최근의 작업부터 정렬됩니다.

유형: String

유효한 값: QUEUED | IN_PROGRESS | FAILED | COMPLETED

오류

모든 작업에 공통적으로 발생하는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.

BadRequestException

요청이 하나 이상의 검증 테스트를 통과하지 못했습니다. 이는 삭제하려는 개체가 존재하지 않거나 터미널이 아닌 상태 (예:IN PROGRESS) 일 때 발생할 수 있습니다. 자세한 내용은 예외 메시지 필드를 참조하십시오.

HTTP 상태 코드: 400

InternalFailureException

에 내부 오류가 발생했습니다. 오류 메시지를 확인하고 문제를 해결한 다음 요청을 다시 시도하세요.

HTTP 상태 코드: 500

LimitExceededException

요청을 너무 많이 보냈거나 입력 파일이 너무 깁니다. 요청을 다시 시도하기 전에 기다리거나 더 작은 파일을 사용하여 요청을 다시 시도하세요.

HTTP 상태 코드: 400

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.