기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 로 트랜스크립션 AWS CLI
AWS CLI 를 사용하여 트랜스크립션을 시작할 때 CLI 수준에서 모든 명령을 실행할 수 있습니다. 또는 사용하려는 명령을 실행한 다음 요청 본문이 포함된 JSON 파일의 AWS 리전 및 위치를 차례로 실행할 수 있습니다. 이 설명서의 예시에서는 두 가지 메서드를 모두 보여 주지만 이 섹션에서는 전자의 메서드를 중점적으로 다룹니다.
AWS CLI 는 스트리밍 트랜스크립션을 지원하지 않습니다.
계속하기 전에 다음을 완료했는지 확인하세요.
+ 미디어 파일을 Amazon S3 버킷에 업로드했습니다. Amazon S3 버킷을 생성하거나 파일을 업로드하는 방법을 잘 모르는 경우 [첫 번째 Amazon S3 버킷 생성](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html) 및 [버킷에 객체 업로드를 참조하세요](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-an-object-bucket.html).
+ [AWS CLI](getting-started.md#getting-started-api)를 설치했습니다.
AWS CLI 명령 [AWS CLI 참조](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/index.html#cli-aws-transcribe) Amazon Transcribe 에서에 대한 모든 명령을 찾을 수 있습니다.
## 새 트랜스크립션 작업 시작
새 트랜스크립션을 시작하려면 `start-transcription-job` 명령을 사용합니다.
1. 터미널 창에서 다음을 입력합니다.
```
aws transcribe start-transcription-job \
```
다음 줄에 '`>`'가 표시되며, 이제 다음 단계에서 설명하는 대로 필수 파라미터를 계속 추가할 수 있습니다.
'`\`'를 생략하고 모든 파라미터를 스페이스로 구분하여 추가할 수도 있습니다.
1. `start-transcription-job` 명령의 경우 `region`, `transcription-job-name`, `media` 및 `language-code` 또는 `identify-language` 중 하나를 포함해야 합니다.
출력 위치를 지정하려면 요청에 `output-bucket-name`을 포함하고, 지정된 출력 버킷의 하위 폴더를 지정하려면 `output-key`도 포함합니다.
```
aws transcribe start-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job \
--media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac \
--language-code en-US
```
모든 파라미터를 추가하는 경우 이 요청은 다음과 같습니다.
```
aws transcribe start-transcription-job --region us-west-2 --transcription-job-name my-first-transcription-job --media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac --language-code en-US
```
`output-bucket-name`을 사용하여 출력 버킷을 지정하지 않기로 선택한 경우, Amazon Transcribe 는 트랜스크립션 출력을 서비스 관리형 버킷에 위치시킵니다. 서비스 관리형 버킷에 저장된 트랜스크립트는 90일 후에 만료됩니다.
Amazon Transcribe 는 다음과 같이 응답합니다.
```
{
"TranscriptionJob": {
"TranscriptionJobName": "my-first-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "en-US",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
},
"StartTime": "2022-03-07T15:03:44.246000-08:00",
"CreationTime": "2022-03-07T15:03:44.229000-08:00"
}
}
```
[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus)가 `IN_PROGRESS`에서 `COMPLETED`로 변경되면 트랜스크립션 작업이 성공한 것입니다. 업데이트된 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus)를 보려면 다음 섹션과 같이 `get-transcription-job` 또는 `list-transcription-job` 명령을 사용합니다.
## 트랜스크립션 작업의 상태 가져오기
트랜스크립션 작업에 대한 정보를 얻으려면 `get-transcription-job` 명령을 사용합니다.
이 명령에 필요한 유일한 파라미터는 작업이 AWS 리전 위치한과 작업 이름입니다.
```
aws transcribe get-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job
```
Amazon Transcribe 는 다음과 같이 응답합니다.
```
{
"TranscriptionJob": {
"TranscriptionJobName": "my-first-transcription-job",
"TranscriptionJobStatus": "COMPLETED",
"LanguageCode": "en-US",
"MediaSampleRateHertz": 48000,
"MediaFormat": "flac",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
},
"Transcript": {
"TranscriptFileUri": "https://s3.the-URI-where-your-job-is-located.json"
},
"StartTime": "2022-03-07T15:03:44.246000-08:00",
"CreationTime": "2022-03-07T15:03:44.229000-08:00",
"CompletionTime": "2022-03-07T15:04:01.158000-08:00",
"Settings": {
"ChannelIdentification": false,
"ShowAlternatives": false
}
}
}
```
트랜스크립션 출력에 대해 자체 Amazon S3 버킷을 선택한 경우이 버킷은와 함께 나열됩니다`TranscriptFileUri`. 서비스 관리형 버킷을 선택한 경우 임시 URI가 제공됩니다. 이 URI를 사용하여 트랜스크립트를 다운로드합니다.
**참고**
서비스 관리형 Amazon S3 버킷URIs는 15분 동안만 유효합니다. URI를 사용할 때 `AccesDenied` 오류가 발생하는 경우 `get-transcription-job` 요청을 다시 실행하여 새 임시 URI를 얻습니다.
## 트랜스크립션 작업 나열
지정된의 모든 트랜스크립션 작업을 나열하려면 `list-transcription-jobs` 명령을 AWS 리전사용합니다.
이 명령에 필요한 유일한 파라미터는 트랜스크립션 작업이 있는 AWS 리전 입니다.
```
aws transcribe list-transcription-jobs \
--region us-west-2
```
Amazon Transcribe 는 다음과 같이 응답합니다.
```
{
"NextToken": "A-very-long-string",
"TranscriptionJobSummaries": [
{
"TranscriptionJobName": "my-first-transcription-job",
"CreationTime": "2022-03-07T15:03:44.229000-08:00",
"StartTime": "2022-03-07T15:03:44.246000-08:00",
"CompletionTime": "2022-03-07T15:04:01.158000-08:00",
"LanguageCode": "en-US",
"TranscriptionJobStatus": "COMPLETED",
"OutputLocationType": "SERVICE_BUCKET"
}
]
}
```
## 트랜스크립션 작업 삭제
트랜스크립션 작업을 삭제하려면 `delete-transcription-job` 명령을 사용합니다.
이 명령에 필요한 유일한 파라미터는 작업이 AWS 리전 위치한과 작업 이름입니다.
```
aws transcribe delete-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job
```
`list-transcription-jobs` 명령을 실행하여 삭제 요청이 성공했는지 확인할 수 있습니다. 더 이상 목록에 작업이 표시되지 않아야 합니다.