기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ListTranscriptionJobs
지정된 기준과 일치하는 트랜스크립션 작업의 목록을 제공합니다. 기준이 지정되지 않은 경우 모든 트랜스크립션 작업이 반환됩니다.
특정 트랜스크립션 작업에 대한 자세한 정보를 보려면GetTranscriptionJob 작업을 사용합니다.
요청 구문
{
"JobNameContains": "string
",
"MaxResults": number
,
"NextToken": "string
",
"Status": "string
"
}
요청 파라미터
모든 작업에 공통되는 파라미터에 대한 자세한 내용은 공통 파라미터를 참조하십시오.
요청은 JSON 형식의 다음 데이터를 받습니다.
- JobNameContains
-
지정된 문자열이 포함된 트랜스크립션 작업만 반환합니다. 검색은 대/소문자를 구분하지 않습니다.
유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.
패턴:
^[0-9a-zA-Z._-]+
필수 항목 여부: 아니요
- MaxResults
-
결과의 각 페이지에서 반환할 최대 트랜스크립션 작업 수입니다. 지정한 값보다 적은 결과가 있는 경우 실제 결과만 반환됩니다. 값을 지정하지 않으면 기본값 5 가 사용됩니다.
유형: Integer
유효한 범위: 최소값 1. 최대값 100입니다.
필수 항목 여부: 아니요
- NextToken
-
ListTranscriptionJobs
요청에서NextToken
반환되는 결과가 표시될 수 있는 것보다 많을 경우 관련 문자열과 함께 응답에 표시됩니다. 다음 페이지의 결과를 가져오려면 이 문자열을 복사하고 복사된 문자열의 값을 포함하여NextToken
요청을 반복하세요. 필요한 만큼 반복하여 모든 결과를 확인합니다.유형: String
길이 제약: 최대 길이는 819입니다.
패턴:
.+
필수 항목 여부: 아니요
- Status
-
지정된 상태의 트랜스크립션 작업만 반환합니다. 작업은 생성 날짜순으로 정렬되며, 가장 최근의 작업이 가장 먼저 정렬됩니다. 포함하지
Status
않으면 모든 트랜스크립션 작업이 반환됩니다.유형: String
유효한 값:
QUEUED | IN_PROGRESS | FAILED | COMPLETED
필수 항목 여부: 아니요
응답 구문
{
"NextToken": "string",
"Status": "string",
"TranscriptionJobSummaries": [
{
"CompletionTime": number,
"ContentRedaction": {
"PiiEntityTypes": [ "string" ],
"RedactionOutput": "string",
"RedactionType": "string"
},
"CreationTime": number,
"FailureReason": "string",
"IdentifiedLanguageScore": number,
"IdentifyLanguage": boolean,
"IdentifyMultipleLanguages": boolean,
"LanguageCode": "string",
"LanguageCodes": [
{
"DurationInSeconds": number,
"LanguageCode": "string"
}
],
"ModelSettings": {
"LanguageModelName": "string"
},
"OutputLocationType": "string",
"StartTime": number,
"TranscriptionJobName": "string",
"TranscriptionJobStatus": "string"
}
]
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- NextToken
-
응답에
NextToken
가 있는 경우 모든 결과가 표시되지 않음을 나타냅니다. 다음 결과 세트를 보려면 결과 출력의NextToken
파라미터와 연결된 문자열을 복사한 다음 복사된 문자열의 값을 포함하여NextToken
요청을 다시 실행합니다. 필요한 만큼 반복하여 모든 결과를 확인합니다.유형: String
길이 제약: 최대 길이는 819입니다.
패턴:
.+
- Status
-
요청에 지정된 상태의 모든 트랜스크립션 작업을 나열합니다. 작업은 생성 날짜순으로 정렬되며, 가장 최근의 작업이 가장 먼저 정렬됩니다.
유형: String
유효한 값:
QUEUED | IN_PROGRESS | FAILED | COMPLETED
- TranscriptionJobSummaries
-
각 결과에 대한 정보 요약을 제공합니다.
유형: TranscriptionJobSummary 객체 배열
오류
모든 작업에 공통적으로 발생하는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.
- BadRequestException
-
요청이 하나 이상의 검증 테스트를 통과하지 못했습니다. 이는 삭제하려는 개체가 존재하지 않거나 터미널이 아닌 상태 (예:
IN PROGRESS
) 일 때 발생할 수 있습니다. 자세한 내용은 예외 메시지 필드를 참조하십시오.HTTP 상태 코드: 400
- InternalFailureException
-
에 내부 오류가 발생했습니다. 오류 메시지를 확인하고 문제를 해결한 다음 요청을 다시 시도하세요.
HTTP 상태 코드: 500
- LimitExceededException
-
요청을 너무 많이 보냈거나 입력 파일이 너무 깁니다. 요청을 다시 시도하기 전에 기다리거나 더 작은 파일을 사용하여 요청을 다시 시도하세요.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.