기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
GetCallAnalyticsJob
지정한 통화 분석 작업에 대한 정보를 제공합니다.
작업 상태를 보려면 을 참조하십시오CallAnalyticsJobStatus
. 상태인COMPLETED
경우 작업이 완료된 것입니다. 에 지정된 URI에서 완성된 성적표를 찾을 수TranscriptFileUri
있습니다. FAILED
상태인 경우 트랜스크립션 작업이 실패한 이유에 대한 세부 정보를FailureReason
제공합니다.
개인 식별 정보 (PII) 수정을 활성화한 경우 편집된 사본이 에 지정된 위치에 표시됩니다RedactedTranscriptFileUri
.
미디어 파일에서 오디오를 삭제하도록 선택한 경우 에서 지정한 위치에서 편집된 미디어 파일을 찾을 수RedactedMediaFileUri
있습니다.
통화 분석 작업 목록을 가져오려면 작업을 사용하세요.ListCallAnalyticsJobs
요청 구문
{
"CallAnalyticsJobName": "string
"
}
요청 파라미터
모든 작업에 공통적인 파라미터에 대한 자세한 내용은 범용 파라미터를 참조하십시오.
요청은 JSON 형식의 다음 데이터를 받습니다.
- CallAnalyticsJobName
-
정보를 얻으려는 통화 분석 작업의 이름입니다. Job 이름은 대/소문자를 구분합니다.
유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.
패턴:
^[0-9a-zA-Z._-]+
Required: Yes
응답 구문
{
"CallAnalyticsJob": {
"CallAnalyticsJobName": "string",
"CallAnalyticsJobStatus": "string",
"ChannelDefinitions": [
{
"ChannelId": number,
"ParticipantRole": "string"
}
],
"CompletionTime": number,
"CreationTime": number,
"DataAccessRoleArn": "string",
"FailureReason": "string",
"IdentifiedLanguageScore": number,
"LanguageCode": "string",
"Media": {
"MediaFileUri": "string",
"RedactedMediaFileUri": "string"
},
"MediaFormat": "string",
"MediaSampleRateHertz": number,
"Settings": {
"ContentRedaction": {
"PiiEntityTypes": [ "string" ],
"RedactionOutput": "string",
"RedactionType": "string"
},
"LanguageIdSettings": {
"string" : {
"LanguageModelName": "string",
"VocabularyFilterName": "string",
"VocabularyName": "string"
}
},
"LanguageModelName": "string",
"LanguageOptions": [ "string" ],
"VocabularyFilterMethod": "string",
"VocabularyFilterName": "string",
"VocabularyName": "string"
},
"StartTime": number,
"Transcript": {
"RedactedTranscriptFileUri": "string",
"TranscriptFileUri": "string"
}
}
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- CallAnalyticsJob
-
작업 상태 및 해당하는 경우 실패 원인을 포함하여 지정된 Call Analytics 작업에 대한 세부 정보를 제공합니다.
유형: CallAnalyticsJob 객체
오류
모든 작업에 공통적으로 발생하는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.
- BadRequestException
-
요청이 하나 이상의 검증 테스트를 통과하지 못했습니다. 이는 삭제하려는 개체가 존재하지 않거나 터미널이 아닌 상태 (예:
IN PROGRESS
) 일 때 발생할 수 있습니다. 자세한 내용은 예외 메시지 필드를 참조하십시오.HTTP 상태 코드: 400
- InternalFailureException
-
에 내부 오류가 발생했습니다. 에 오류 메시지를 확인하고 문제를 해결한 다음 요청을 다시 시도하세요.
HTTP 상태 코드: 500
- LimitExceededException
-
요청을 너무 많이 보냈거나 입력 파일이 너무 깁니다. 요청을 다시 시도하기 전에 기다리거나 더 작은 파일을 사용하여 요청을 다시 시도하세요.
HTTP 상태 코드: 400
- NotFoundException
-
요청한 리소스를 찾을 수 없습니다. 지정한 이름이 올바른지 확인하고 요청을 다시 시도하세요.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.