기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# MediaConvert EventBridge 이벤트 목록
AWS Elemental MediaConvert 는 작업 상태가 변경될 때 Amazon EventBridge에 이벤트를 내보냅니다. 이러한 이벤트에 대한 [Eventbridge 규칙](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)을 생성할 수 있습니다.
대부분의 작업은 이러한 이벤트 중 일부만 내보내며, 가장 일반적인 이벤트는 `INPUT_INFORMATION`, `PROGRESSING`, `COMPLETE`입니다.
각 이벤트 유형에 대한 자세한 내용을 알아보려면 **이벤트** 열에 있는 링크를 선택합니다.
**MediaConvert 이벤트**
| Event | 전송된 시간 | 포함 |
| --- | --- | --- |
| [INPUT\$1INFORMATION](ev_status_input_information.md) | MediaConvert가 작업 처리를 시작한 후 즉시. | 프레임 높이 및 너비, 프레임 속도 및 코덱과 같은 미디어 정보. 단일 이벤트의 모든 입력에 대한 MediaConvert의 정보. |
| [진행 중](ev_status_progressing.md) | 작업이 `SUBMITTED` 상태에서 `PROGRESSING` 상태로 이동합니다. | 기본 작업 세부 정보. |
| [STATUS\$1UPDATE](ev_status_status_update.md) | MediaConvert에서 작업 처리 시작 후 약 1분. 이후 약 1분마다 작업이 완료되거나 오류가 발생할 때까지 전송됩니다. | 작업 진행도는 작업 시작 후 트랜스코딩된 프레임 수로 표시됩니다. |
| [완료](ev_status_complete.md) | 작업이 완료되고 MediaConvert가 모든 출력을 오류 없이 성공적으로 씁니다. | 완료된 작업에 대한 경고 및 출력 정보. |
| [CANCELED](ev_status_canceled.md) | 작업이 취소됩니다. | 기본 작업 세부 정보. |
| [오류](ev_status_error.md) | 작업에 오류가 있습니다. 최소 하나의 출력에 오류가 있습니다. | 오류 코드 및 모든 메시지. 작업 오류 상태에 대한 기타 모든 임시 작업 정보가 포함됩니다. |
| [NEW\$1WARNING](ev_status_new_warning.md) | 경고 조건이 발생합니다. | 경고 코드 또는 모든 경고 메시지. |
| [QUEUE\$1HOP](ev_status_queue_hop.md) | 작업이 대기열을 건너뜁니다. | 두 대기열의 ARN 및 대기열 내의 작업 우선순위입니다. |
**참고**
MediaConvert는 `SUBMITTED` 이벤트를 내보내지 않습니다. MediaConvert 콘솔에서의 호출을 포함하여 API 직접 호출을 수행할 때 EventBridge 이벤트를 수신하려면 AWS CloudTrail 추적을 생성해야 합니다. 자세한 내용은 [를 통한 AWS 서비스 이벤트 액세스 AWS CloudTrail](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) 및 [ CloudTrail 추적 작업을 참조하세요](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html).
MediaConvert가 이벤트를 Amazon EventBridge로 전송하는 경우 결과 JSON에는 다음 필드가 있습니다.
+ **버전(version)** - 현재 모든 이벤트에 대해 0(영)입니다.
+ **id** - 모든 이벤트에 대해 생성된 버전 4 UUID입니다.
+ **detail-type** - 전송 중인 이벤트의 유형입니다.
+ **소스(source)** - 이벤트를 생성한 서비스를 식별합니다.
+ **계정** - 작업을 실행하는 12자리 AWS 계정 ID입니다.
+ **time**(시간) - 이벤트가 발생한 시간입니다.
+ **리전** - 버킷의 AWS 리전 (을)를 식별합니다.
+ **리소스** - 버킷의 Amazon 리소스 이름(ARN)을 포함하는 JSON 배열입니다.
+ **세부 정보** - 이벤트에 대한 정보를 포함하는 JSON 객체입니다.
다음 섹션에는 MediaConvert가 내보내는 모든 EventBridge 이벤트에 대한 이벤트 메시지 세부 정보, JSON 응답, 이벤트 패턴이 있습니다.
**Topics**
+ [INPUT\$1INFORMATION 상태 이벤트](ev_status_input_information.md)
+ [PROGRESSING 상태 이벤트](ev_status_progressing.md)
+ [STATUS\$1UPDATE 상태 이벤트](ev_status_status_update.md)
+ [COMPLETE 상태 이벤트](ev_status_complete.md)
+ [CANCELED 상태 이벤트](ev_status_canceled.md)
+ [ERROR 상태 이벤트](ev_status_error.md)
+ [NEW\$1WARNING 상태 이벤트](ev_status_new_warning.md)
+ [QUEUE\$1HOP 상태 이벤트](ev_status_queue_hop.md)
# INPUT\$1INFORMATION 상태 이벤트
MediaConvert는 작업 처리가 시작된 후 및 MediaConvert가 입력에 대한 정보를 읽은 후에 `INPUT_INFORMATION` 이벤트를 전송합니다. 이벤트에는 주로 프레임 높이와 폭, 프레임 속도, 코덱 등 입력에 대한 미디어 정보가 포함됩니다.
MediaConvert에는 단일 이벤트의 모든 입력에 대한 정보가 포함됩니다.
다음 JSON은 단일 입력 작업의 `INPUT_INFORMATION` 상태를 포함하는 예제 이벤트입니다.
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2022-12-19T19:07:12Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1671476818694-phptj0"
],
"detail": {
"timestamp": 1671476832075,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1671476818694-phptj0",
"status": "INPUT_INFORMATION",
"userMetadata": {},
"inputDetails": [
{
"id": 1,
"uri": "s3://amzn-s3-demo-bucket/file/file.mp4",
"audio": [
{
"channels": 2,
"codec": "AAC",
"language": "UND",
"sampleRate": 44100,
"streamId": 2
}
],
"video": [
{
"bitDepth": 8,
"codec": "H_264",
"colorFormat": "YUV_420",
"fourCC": "avc1",
"frameRate": 24,
"height": 1080,
"interlaceMode": "PROGRESSIVE",
"sar": "1:1",
"standard": "UNSPECIFIED",
"streamId": 1,
"width": 1920
}
]
}
]
}
}
```
다음 샘플 JSON을 사용하여 상태가 `INPUT_INFORMATION`인 작업에 대한 EventBridge 이벤트 패턴을 생성할 수 있습니다.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["INPUT_INFORMATION"]
}
}
```
# PROGRESSING 상태 이벤트
MediaConvert는 작업 상태가 `SUBMITTED`에서 `PROGRESSING`(으)로 변동될 때 `PROGRESSING` 이벤트를 전송합니다.
**참고**
작업이 48시간 동안 `PROGRESSING` 상태로 유지되면 서비스가 `ERROR` 상태로 전환하고 작업을 중단합니다. `ERROR` 상태로 끝나는 직업에 대해서는 비용이 청구되지 않습니다.
다음 JSON은 `PROGRESSING` 작업 상태를 포함하는 예제 이벤트입니다.
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2022-12-19T19:20:21Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1671477617078-2886ye"
],
"detail": {
"timestamp": 1671477621654,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1671477617078-2886ye",
"status": "PROGRESSING",
"userMetadata": {}
}
}
```
다음 샘플 JSON을 사용하여 상태가 `PROGRESSING`인 작업에 대한 EventBridge 이벤트 패턴을 생성할 수 있습니다.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["PROGRESSING"]
}
}
```
# STATUS\$1UPDATE 상태 이벤트
MediaConvert는 작업 처리 시작 후 약 1분 시점에 `STATUS_UPDATE` 이벤트를 전송합니다. 기본적으로 이후 약 1분마다 서비스가 트랜스코딩을 완료하거나 오류가 발생할 때까지 업데이트가 전송됩니다.
선택적으로 **Status update interval(상태 업데이트 간격)** 설정을 사용하여 작업에 다른 업데이트 빈도를 지정할 수 있습니다. 기본값보다 더 자주 업데이트하려면 10, 12, 15, 20 또는 30초를 선택할 수 있습니다. 기본값보다 덜 자주 업데이트하려면 2\$110분을 선택할 수 있습니다(1분 간격). 자세한 내용은 [상태 업데이트 간격 조정](adjusting-the-status-update-interval.md)을(를) 참조하세요.
`STATUS_UPDATE` 이벤트에는 작업의 현재 단계에 대한 정보가 포함됩니다. 가능한 경우 여기에는 작업 및 단계 완료율이 포함됩니다.
작업 단계는 다음과 같습니다.
+ `PROBING` 단계에서는 서비스가 트랜스코딩을 시작할 준비를 하기 위해 입력에 대한 정보를 읽습니다.
+ `TRANSCODING` 단계에서는 서비스가 콘텐츠를 디먹싱, 디코딩 및 리먹싱합니다. 일부 작업에서는 서비스가 이 단계에서 출력을 Amazon S3 버킷에 업로드하기 시작합니다. 모든 트랜스코딩이 완료되면 이 단계가 완료됩니다.
+ `UPLOADING` 단계에서는 서비스가 나머지 트랜스코딩된 출력을 Amazon S3 버킷으로 업로드합니다.
다음 JSON은 `STATUS_UPDATE` 작업 상태를 포함하는 예제 이벤트입니다.
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2022-12-19T19:21:21Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1671477617078-2886ye"
],
"detail": {
"timestamp": 1671477681737,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1671477617078-2886ye",
"status": "STATUS_UPDATE",
"userMetadata": {},
"framesDecoded": 353,
"jobProgress": {
"phaseProgress": {
"PROBING": {
"status": "COMPLETE",
"percentComplete": 100
},
"TRANSCODING": {
"status": "PROGRESSING",
"percentComplete": 2
},
"UPLOADING": {
"status": "PENDING",
"percentComplete": 0
}
},
"jobPercentComplete": 7,
"currentPhase": "TRANSCODING",
"retryCount": 0
}
}
}
```
다음 샘플 JSON을 사용하여 상태가 `STATUS_UPDATE`인 작업에 대한 EventBridge 이벤트 패턴을 생성할 수 있습니다.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["STATUS_UPDATE"]
}
}
```
# 상태 업데이트 간격 조정
기본적으로는 분당 약 한 번씩 Amazon EventBridge에 `STATUS_UPDATE` 이벤트를 AWS Elemental MediaConvert 전송합니다. 이러한 상태 업데이트는 작업이 어떻게 진행되고 있는지에 대한 정보를 제공합니다. 작업에서 다른 업데이트 빈도를 지정하여 상태 업데이트 간격을 조정할 수 있습니다.
**STATUS\$1UPDATE 빈도를 지정하려면 다음을 수행합니다.**
1. **작업 생성** 페이지의 왼쪽에 있는 **작업** 창의 **작업 설정** 섹션에서 **AWS 통합**을 선택합니다.
1. **AWS 통합 **섹션의 **(sec)(상태 업데이트 간격(초))**에서 업데이트 **간격을 초 단위로** 선택하세요.
API나 SDK를 사용하는 경우에는 작업의 JSON 파일에서 이 설정을 찾을 수 있습니다. 설정 이름은 [statusUpdateInterval](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-createjobrequest-statusupdateinterval)입니다.
# COMPLETE 상태 이벤트
MediaConvert는 모든 출력이 오류 없이 Amazon S3에 기록될 때 `COMPLETE` 이벤트를 전송합니다. 여기에는 완료된 작업에 대한 경고와 출력 정보가 모두 들어 있습니다. 작업 출력 파일 이름 및 경로에 대한 자세한 내용은 [출력 파일 이름 및 경로](output-file-names-and-paths.md)(을)를 참조하세요.
다음 JSON은 `COMPLETE` 작업 상태를 포함하는 예제 이벤트입니다.
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2022-12-19T19:07:12Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2::jobs/1671476818694-phptj0"
],
"detail": {
"timestamp": 1671476832124,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1671476818694-phptj0",
"status": "COMPLETE",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/file/file.mp4"
],
"durationInMs": 30041,
"videoDetails": {
"widthInPx": 1920,
"heightInPx": 1080,
"qvbrAvgQuality": 7.38,
"qvbrMinQuality": 7,
"qvbrMaxQuality": 8,
"qvbrMinQualityLocation": 2168,
"qvbrMaxQualityLocation": 25025
}
}
],
"type": "FILE_GROUP"
}
],
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
]
}
}
```
`COMPLETE` 이벤트에는 작업 및 출력에 대한 추가 정보가 포함됩니다. 다음 테이블에는 작업 이벤트 메시지 세부 정보에 표시되는 다양한 속성 목록에 대한 설명이 있습니다.
**완료 이벤트 메시지 세부 정보**
| 속성 | 데이터 유형 | 세부 정보 |
| --- | --- | --- |
| `paddingInserted` | 정수 | MediaConvert가 작업의 모든 출력 전반에 삽입한 총 빈 프레임 지속 시간(밀리초). 비디오 패딩은 빈 프레임을 삽입하여 오디오와 비디오 지속 시간을 지속적으로 정렬하는 데 도움이 됩니다. `paddingInserted` 값이 크면 더 많은 빈 프레임이 삽입되었음을 나타냅니다. 이 값은 입력 오디오 트랙이 어느 정도나 늦게 시작하거나 일찍 끝나는지, 아니면 둘 다인지 나타내기도 합니다. |
| `qvbrAvgQuality` | 실수 | 품질 기반 가변 비트레이트(QVBR) 출력의 평균 비디오 품질. QVBR 출력에만 포함. |
| `qvbrMinQuality` | 실수 | QVBR 출력에서 감지된 최저 비디오 품질. QVBR 출력에만 포함. |
| `qvbrMaxQuality` | 실수 | QVBR 출력에서 감지된 최고 비디오 품질. QVBR 출력에만 포함. |
| `qvbrMinQualityLocation` | 정수 | 출력에서 `qvbrMinQuality`이(가) 감지된 위치(밀리초 단위). 출력 비디오 품질 및 대역폭 사용량을 검토하면서 `qvbrMinQualityLocation` 사용 가능. QVBR 출력에만 포함. |
| `qvbrMaxQualityLocation` | 정수 | 출력에서 `qvbrMaxQuality`이(가) 감지된 위치(밀리초 단위). 출력 비디오 품질 및 대역폭 사용량을 검토하면서 `qvbrMaxQualityLocation` 사용 가능. QVBR 출력에만 포함. |
| `warnings` code count | 배열 정수 정수 | 작업에서 표시된 모든 경고 코드 및 경고 코드 발생 횟수. 자세한 내용은 [경고 코드](warning_codes.md)을(를) 참조하세요. |
| `blackVideoDetected` | 정수 | 입력에도 표시되는 출력 내 블랙 비디오 프레임 총 지속 시간(밀리초 단위). `blackVideoDetected`에는 MediaConvert가 삽입한 검은색 프레임은 포함되지 않습니다. |
| `blackVideoSegments` `start` `end` | 배열 정수 정수 | 출력에서 블랙 비디오 프레임이 감지된 위치. 출력에 있는 블랙 비디오의 개별 세그먼트는 시작 및 종료 지점이 표시됩니다. `blackVideoSegments`에는 MediaConvert가 삽입한 검은색 프레임은 포함되지 않습니다. |
| `averageBitrate` | 정수 | 재생 시간을 총 비트로 나누어 계산한 비디오 출력의 평균 비트레이트입니다. |
다음 샘플 JSON을 사용하여 상태가 `COMPLETE`인 작업에 대한 EventBridge 이벤트 패턴을 생성할 수 있습니다.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["COMPLETE"]
}
}
```
# 출력 파일 이름 및 경로
EventBridge 작업 `COMPLETE` 알림에는 JSON으로 출력된 결과에 대한 세부 정보가 포함됩니다. 이 정보에는 매니페스트, 미디어 애셋을 비롯한 작업 출력의 파일명과 경로가 포함됩니다.
가 AWS Elemental MediaConvert 생성하는 파일은 작업에서 설정한 출력 그룹에 따라 달라집니다. 예를 들어 DASH ISO 패키지에는 .mpd 매니페스트 및 .mp4 미디어 조각 파일이 포함되어 있습니다.
응답 정보의 다음 속성에서 출력 파일 이름 및 경로 정보를 찾을 수 있습니다.
`playlistFilePaths`
다변량 재생 목록의 Amazon S3 파일 경로 목록입니다.
`outputFilePaths`
미디어 또는 매니페스트의 파일 경로(출력 그룹 유형에 따라 다름).
`type`
출력 그룹의 유형으로, `playlistFilePaths` 및 `outputFilePaths`에 나열되는 파일 결정.
다음 표에 출력 그룹 유형에 따라 이러한 속성의 값이 요약되어 있습니다.
| Type | playlistFilePaths | outputFilePaths |
| --- | --- | --- |
| FILE\$1GROUP(표준 출력) | not returned(반환되지 않음) | 미디어 파일의 파일 이름 및 경로. 예제: `s3://amzn-s3-demo-bucket/file/file.mp4` |
| FILE\$1GROUP(추가 프레임 캡처 출력 있음) | not returned(반환되지 않음) | 캡처한 최종 이미지의 파일 이름 및 경로. 예제: `s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg` |
| HLS\$1GROUP | 다변량 재생 목록의 파일 이름 및 경로입니다. 예제: `s3://amzn-s3-demo-bucket/hls/main.m3u8` | 개별 출력에 대한 매니페스트의 파일 이름 및 경로. 예제: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/mediaconvert/latest/ug/output-file-names-and-paths.html) |
| DASH\$1ISO\$1GROUP | 매니페스트의 파일 이름 및 경로. 예제: `s3://amzn-s3-demo-bucket/dash/1.mpd` | not returned(반환되지 않음) |
| CMAF\$1GROUP | 각 최상위 매니페스트의 파일 이름 및 경로. 예제: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/mediaconvert/latest/ug/output-file-names-and-paths.html) | not returned(반환되지 않음) |
| MS\$1SMOOTH\$1GROUP | 서버 측 매니페스트의 파일 이름 및 경로. 예제: `s3://amzn-s3-demo-bucket/smooth/1.ism` | 각 개별 출력에 대한 비디오 매니페스트의 파일 이름 및 경로. 예제: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/mediaconvert/latest/ug/output-file-names-and-paths.html) |
각 출력 그룹 유형에 대한 JSON 형식의 샘플에 대한 응답은 다음 토픽을 참조하세요.
**Topics**
+ [파일 그룹](file-group.md)
+ [프레임 캡처 출력이 있는 파일 그룹](file-group-with-frame-capture-output.md)
+ [Apple HLS 그룹](apple-hls-group.md)
+ [DASH ISO 그룹](dash-iso-group.md)
+ [CMAF 그룹](cmaf-group.md)
+ [Microsoft Smooth Streaming 그룹](microsoft-smooth-streaming-group.md)
# 파일 그룹
다음은 상태가 `COMPLETE`인 작업에 대한 Amazon EventBridge 샘플 이벤트입니다. 예제에는 파일 그룹의 출력 파일 경로 정보가 포함되어 있습니다.
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
"start": 0,
"end": 10
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/file/file.mp4"
],
"durationInMs": 180041,
"videoDetails": {
"averageBitrate": 200000,
"widthInPx": 1280,
"heightInPx": 720,
"qvbrAvgQuality": 7.38,
"qvbrMinQuality": 7,
"qvbrMaxQuality": 8,
"qvbrMinQualityLocation": 2168,
"qvbrMaxQualityLocation": 25025
},
}
],
"type": "FILE_GROUP"
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
],
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**참고**
QVBR 통계는 비디오 출력에서 품질 기반 가변 비트레이트(QVBR) 속도 제어를 적용하는 경우에만 사용할 수 있습니다.
# 프레임 캡처 출력이 있는 파일 그룹
이 안내서에는 상태가 `COMPLETE`인 작업에 대한 Amazon EventBridge 예제 이벤트가 있습니다. 다음 예제에서는 프레임 캡처 출력이 있는 파일 그룹의 출력 파일 경로 정보가를 보여 줍니다.
*프레임 캡처 출력*은 비디오의 각 프레임의 스틸 이미지를 생성하기 위해 설정하는 출력입니다. 정규 **파일 그룹** 출력 그룹과 비슷하게 설정합니다. 단, 오디오 구성 요소를 제거하고 컨테이너는 **컨테이너 없음**을 선택한 다음 비디오 코덱은 **JPEG로 프레임 캡처**를 선택합니다.
**참고**
정규 오디오 및 비디오 출력이 있는 작업에만 프레임 캡처 출력을 생성할 수 있습니다. MediaConvert는 프레임 캡처 출력으로만 구성된 작업을 지원하지 않습니다.
프레임 캡처 출력을 생성하면 `COMPLETE` 상태에 `outputFilePaths` 속성이 포함됩니다. 캡처한 최종 이미지의 파일 이름 및 경로.
**작은 정보**
이 서비스는 프레임 캡처 파일 이름에 자동 번호 지정이 포함되어 있으므로 마지막 이미지 이름에서 모든 이미지 이름을 유추할 수 있습니다. 예를 들어 `outputFilePaths` 값이 `s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg`인 경우 동일한 위치에 이름이 `file.0000001`, `file.0000002` 등으로 지정된 35개의 다른 이미지가 있음을 유추할 수 있습니다.
다음은 상태가 `COMPLETE`인 작업에 대한 EventBridge 샘플 이벤트입니다. 여기에는 프레임 캡처 출력이 있는 파일 그룹의 출력 파일 경로 정보가 포함됩니다.
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg"
],
"durationInMs": 185000,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720
}
}
],
"type": "FILE_GROUP"
},
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/file/file.mp4"
],
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "FILE_GROUP"
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**참고**
품질 기반 가변 비트레이트(QVBR) 통계는 비디오 출력에서 QVBR 속도 제어를 적용하는 경우에만 사용할 수 있습니다.
# Apple HLS 그룹
다음은 상태가 `COMPLETE`인 작업에 대한 Amazon EventBridge 샘플 이벤트입니다. 여기에는 Apple HLS 그룹의 출력 파일 경로 정보가 포함됩니다.
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/hls/mainv2.m3u8"
],
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 426,
"heightInPx": 240,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
},
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/hls/mainv1.m3u8"
],
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "HLS_GROUP",
"playlistFilePaths": [
"s3://amzn-s3-demo-bucket/hls/main.m3u8"
]
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**참고**
품질 기반 가변 비트레이트(QVBR) 통계는 비디오 출력에서 QVBR 속도 제어를 적용하는 경우에만 사용할 수 있습니다.
# DASH ISO 그룹
다음은 상태가 `COMPLETE`인 작업에 대한 Amazon EventBridge 샘플 이벤트입니다. 여기에는 DASH ISO 그룹의 출력 파일 경로 정보가 포함됩니다.
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "DASH_ISO_GROUP",
"playlistFilePaths": [
"s3://amzn-s3-demo-bucket/dash/1.mpd"
]
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**참고**
품질 기반 가변 비트레이트(QVBR) 통계는 비디오 출력에서 QVBR 속도 제어를 적용하는 경우에만 사용할 수 있습니다.
# CMAF 그룹
다음은 상태가 `COMPLETE`인 작업에 대한 EventBridge 샘플 이벤트입니다. 여기에는 CMAF 그룹의 출력 파일 경로 정보가 포함됩니다.
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 720,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "CMAF_GROUP",
"playlistFilePaths": [
"s3://amzn-s3-demo-bucket/cmaf/1.mpd",
"s3://amzn-s3-demo-bucket/cmaf/1.m3u8"
]
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**참고**
품질 기반 가변 비트레이트(QVBR) 통계는 비디오 출력에서 QVBR 속도 제어를 적용하는 경우에만 사용할 수 있습니다.
# Microsoft Smooth Streaming 그룹
다음은 상태가 `COMPLETE`인 작업에 대한 EventBridge 샘플 이벤트입니다. 여기에는 Microsoft 스무드 스트리밍 그룹의 출력 파일 경로 정보가 포함됩니다.
```
{
"detail": {
"status": "COMPLETE",
"paddingInserted": 0,
"blackVideoDetected": 10,
"blackSegments": [
{
"start": 0,
"end": 10
}
],
"outputGroupDetails": [
{
"outputDetails": [
{
"outputFilePaths": [
"s3://amzn-s3-demo-bucket/smooth/1_va.ismv"
],
"durationInMs": 180041,
"blackVideoDurationInMs": 0,
"videoDetails": {
"widthInPx": 1280,
"heightInPx": 534,
"averageQVBRScore": 7.38,
"minimumQVBRScore": 7,
"maximumQVBRScore": 8,
"minimumQVBRScoreLocationInMs": 2168,
"maximumQVBRScoreLocationInMs": 25025
}
}
],
"type": "MS_SMOOTH_GROUP",
"playlistFilePaths": [
"s3://amzn-s3-demo-bucket/smooth/1.ism"
]
}
],
"timestamp": 1536964380391,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1536964333549-opn151",
"userMetadata": {},
"warnings": [
{
"code": 000000,
"count": 1
}
]
},
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-09-14T21:54:31Z",
"region": "us-west-2",
"resources": [
"arn:aws:mediaconvert:us-west-2:111122223333:jobs/1536961999428-kxngbl"
]
}
```
**참고**
품질 기반 가변 비트레이트(QVBR) 통계는 비디오 출력에서 QVBR 속도 제어를 적용하는 경우에만 사용할 수 있습니다.
# CANCELED 상태 이벤트
MediaConvert는 작업이 취소될 때 `CANCELED` 이벤트를 전송합니다. 여기에는 `timestamp`, `accountID`, `queue`, `jobId`, `userMetadata` 등의 기본 작업 세부 정보가 들어 있습니다.
다음 JSON은 `CANCELED` 작업 상태를 포함하는 예제 이벤트입니다.
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-01-07T23:35:20Z",
"region": "us-west-2",
"resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
"detail": {
"timestamp": 1515368120764,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1515368087458-qnoxtd",
"status": "CANCELED",
"userMetadata": {}
}
}
```
다음 샘플 JSON을 사용하여 상태가 `CANCELED`인 작업에 대한 EventBridge 이벤트 패턴을 생성할 수 있습니다.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["CANCELED"]
}
}
```
# ERROR 상태 이벤트
MediaConvert는 하나 이상의 출력에 오류가 있을 때 `ERROR` 이벤트를 전송합니다. 하나 이상의 오류 코드 및 메시지와, 작업의 오류 상태에 대한 경고 또는 기타 한시적 작업 정보. 오류 코드에 대한 자세한 내용은 [오류 코드](mediaconvert_error_codes.md)(을)를 참조하세요.
다음 JSON은 `ERROR` 작업 상태를 포함하는 예제 이벤트입니다.
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-01-07T23:35:20Z",
"region": "us-west-2",
"resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
"detail": {
"timestamp": 1515368120764,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1515368087458-qnoxtd",
"status": "ERROR",
"errorCode": 1040,
"errorMessage": "Example error message",
"userMetadata": {}
}
}
```
다음 샘플 JSON을 사용하여 상태가 `ERROR`인 작업에 대한 EventBridge 이벤트 패턴을 생성할 수 있습니다.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["ERROR"]
}
}
```
# NEW\$1WARNING 상태 이벤트
MediaConvert는 경고 조건이 발생할 때 `NEW_WARNING` 이벤트를 전송합니다. 경고 조건이 발생하더라도 작업 실행이 중지되지 않습니다. 제출 대기열 ARN, 작업 ID 및 경고 메시지입니다. 경고 메시지는 작업이 중지되지 않지만 작업이 계획대로 진행되고 있지 않음을 나타낼 수 있는 조건에 대해 알려줍니다.
예를 들어, 건너뛰기 대기열로 설정한 작업은 지정한 대기 시간에 도달하지만 건너뛸 수 없습니다.
`NEW_WARNING`에는 가장 최근의 경고 메시지만 포함됩니다. 이전 경고는 경고 조건이 여전히 유효하더라도 보고되지 않습니다.
메시지 그룹에 대한 자세한 내용은 [경고 코드](warning_codes.md)(을)를 참조하세요.
다음 JSON은 `NEW_WARNING` 작업 상태를 포함하는 예제 이벤트입니다.
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-01-07T23:35:20Z",
"region": "us-west-2",
"resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
"detail": {
"timestamp": 1515368120764,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"jobId": "1515368087458-qnoxtd",
"status": "NEW_WARNING",
"warningCode": "000000",
"warningMessage": "Example warning message",
"userMetadata": {}
}
}
```
다음 샘플 JSON을 사용하여 상태가 `NEW_WARNING`인 작업에 대한 EventBridge 이벤트 패턴을 생성할 수 있습니다.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["NEW_WARNING"]
}
}
```
# QUEUE\$1HOP 상태 이벤트
MediaConvert는 작업이 대기열에 추가될 때 `QUEUE_HOP` 이벤트를 전송합니다. 두 대기열의 ARN 및 대기열 내의 작업 우선순위입니다.
작업이 대기열을 건너뛰면서 작업에 부여할 새 우선순위를 대기열 건너뛰기 구성에서 지정하지 않은 한 `priority`과 `previousPriority`는 동일합니다.
다음 JSON은 `QUEUE_HOP` 작업 상태를 포함하는 예제 이벤트입니다.
```
{
"version": "0",
"id": "1234abcd-12ab-34cd-56ef-1234567890ab",
"detail-type": "MediaConvert Job State Change",
"source": "aws.mediaconvert",
"account": "111122223333",
"time": "2018-01-07T23:35:20Z",
"region": "us-west-2",
"resources": ["arn:aws:mediaconvert:us-west-2:111122223333:jobs/1515368087458-qnoxtd"],
"detail": {
"timestamp": 1515368120764,
"accountId": "111122223333",
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"previousQueue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Alternate",
"priority": 0,
"previousPriority": 0,
"jobId": "1515368087458-qnoxtd",
"status": "QUEUE_HOP",
"userMetadata": {}
}
}
```
다음 샘플 JSON을 사용하여 상태가 `QUEUE_HOP`인 작업에 대한 EventBridge 이벤트 패턴을 생성할 수 있습니다.
```
{
"source": ["aws.mediaconvert"],
"detail-type": ["MediaConvert Job State Change"],
"detail": {
"status": ["QUEUE_HOP"]
}
}
```