

# Events with COMPLETE status
COMPLETE

MediaConvert sends the event for `COMPLETE` when all outputs are written to Amazon S3 without errors. It contains both warnings and output information for the completed job. For more information about output file names and paths, see [Output file names and paths](output-file-names-and-paths.md).

The following JSON is an example event containing the `COMPLETE` status for a job.

```
{
    "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` events contain additional information about your job and outputs. The following table lists and describes the different properties available in job event message details.


**COMPLETE event message details**  

| Property | Data type | Details | 
| --- | --- | --- | 
|  `paddingInserted`  |  integer  | The total duration of blank frames MediaConvert inserted across all outputs in your job, in milliseconds. Video padding inserts blank frames to help keep audio and video durations aligned. Large `paddingInserted` values show that more blank frames were inserted. These values also show to what extend your input audio tracks start late, or end early, or both. | 
|  `qvbrAvgQuality`  |  float  |  The average video quality of your Quality-Defined Variable Bitrate (QVBR) output. Included for QVBR outputs only.  | 
|  `qvbrMinQuality`  |  float  |  The minimum video quality detected in your QVBR output.  Included for QVBR outputs only.  | 
|  `qvbrMaxQuality`  |  float  |  The maximum video quality detected in your QVBR output. Included for QVBR outputs only.  | 
|  `qvbrMinQualityLocation`  |  integer  |  The location in your output where `qvbrMinQuality` was detected, in milliseconds. You can use `qvbrMinQualityLocation` while reviewing your output video quality and bandwidth usage. Included for QVBR outputs only.  | 
|  `qvbrMaxQualityLocation`  |  integer  |  The location in your output where `qvbrMaxQuality` was detected, in milliseconds. You can use `qvbrMaxQualityLocation` while reviewing your output video quality and bandwidth usage. Included for QVBR outputs only.  | 
|  `warnings`  code  count  |  array integer integer  |  Any warning codes seen in the job and the number of times they occurred. For more information, see [Warning codes](warning_codes.md).  | 
|  `blackVideoDetected`  |  integer  |  The total duration of black video frames in your outputs that are also present in your inputs, in milliseconds. `blackVideoDetected` does not include any black frames inserted by MediaConvert.  | 
|  `blackVideoSegments`  `start`  `end`  |  array integer integer  |  The location or locations in your output where black video frames were detected. Each segment of black video in your output is shown with its own start and end. `blackVideoSegments` does not include any black frames inserted by MediaConvert.  | 
|  `averageBitrate`  |  integer  |  The average bitrate of your video output, calculated by dividing the duration by the total bits.  | 

You can use the following sample JSON to create an EventBridge event pattern for jobs with a status of `COMPLETE`.

```
{
  "source": ["aws.mediaconvert"],
  "detail-type": ["MediaConvert Job State Change"],
  "detail": {
    "status": ["COMPLETE"]
  }
}
```

# Output file names and paths
Output file names and pathsFind output file names and paths in EventBridge notifications

You can receive output file names and paths, including manifest and media file outputs, by using Amazon EventBridge with AWS Elemental MediaConvert jobs.

The EventBridge job `COMPLETE` notification includes details about your output in JSON. This information includes the file names and paths for the outputs of the job—including manifests and media assets.

The files that AWS Elemental MediaConvert creates depends on the output groups that you set up in the job. For example, DASH ISO packages contain an .mpd manifest and .mp4 media fragment files.

You can find output file name and path information in the following properties:

`playlistFilePaths`  
A list of the Amazon S3 file paths to the multivariant playlists.

`outputFilePaths`  
The file path to either the media or the manifest, depending on the output group type.

`type`  
The type of output group, which determines what files are listed in the `playlistFilePaths` and `outputFilePaths`.

The following table summarizes the values for these properties, depending on the output group type.


| Type | playlistFilePaths | outputFilePaths | 
| --- | --- | --- | 
| FILE\$1GROUP (standard output) | not returned |  File name and path of the media file. Example: `s3://amzn-s3-demo-bucket/file/file.mp4`  | 
| FILE\$1GROUP (with additional frame capture output) | not returned |  File name and path of the final captured image. Example: `s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg`  | 
| HLS\$1GROUP |  File name and path of the multivariant playlist. Example: `s3://amzn-s3-demo-bucket/hls/main.m3u8`  |  File name and path of the manifests for the individual outputs. Examples: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/mediaconvert/latest/ug/output-file-names-and-paths.html)  | 
| DASH\$1ISO\$1GROUP |  File name and path of the manifest. Example: `s3://amzn-s3-demo-bucket/dash/1.mpd`  | not returned | 
| CMAF\$1GROUP |  File name and path for each of the top-level manifests. Examples: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/mediaconvert/latest/ug/output-file-names-and-paths.html)  | not returned | 
| MS\$1SMOOTH\$1GROUP |  File name and path of the server-side manifest. Example: `s3://amzn-s3-demo-bucket/smooth/1.ism`  |  File name and path of the video manifests for each of the individual outputs. Examples: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/mediaconvert/latest/ug/output-file-names-and-paths.html)  | 

For sample responses in JSON for each output group type, see the following topics:

**Topics**
+ [

# File group
](file-group.md)
+ [

# File group with a frame capture output
](file-group-with-frame-capture-output.md)
+ [

# Apple HLS group
](apple-hls-group.md)
+ [

# DASH ISO group
](dash-iso-group.md)
+ [

# CMAF group
](cmaf-group.md)
+ [

# Microsoft Smooth Streaming group
](microsoft-smooth-streaming-group.md)

# File group
File group

The following is an Amazon EventBridge sample event for a job with a `COMPLETE` status. The example includes output file path information for a file group.

```
{
    "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"
    ]
}
```

**Note**  
QVBR statistics are only available when your video output uses Quality-Defined Variable Bitrate (QVBR) rate control.

# File group with a frame capture output
File group with frame capture output

This guide provides an Amazon EventBridge example event for a job with a `COMPLETE` status. It also shows output file path information for a file group with a frame capture output. 

A *frame capture output* is an output that you set up to create still images of video. You set it up similar to a regular **File group** output group. However, you remove the audio component, choose **No container** for the container, and then choose **Frame capture to JPEG** for the video codec.

**Note**  
You can create frame capture outputs only in jobs that also have a regular audio and video output. MediaConvert doesn't support jobs that consist only of a frame capture output.

When you create a frame capture output, the `COMPLETE` status includes the `outputFilePaths` property. This tells you the file name and path of the final captured image. 

**Tip**  
Because the service includes automatic numbering in the frame capture file names, you can infer all the image names from the final one. For example, if your `outputFilePaths` value is `s3://amzn-s3-demo-bucket/frameoutput/file.0000036.jpg`, you can infer that there are 35 other images in the same location, named `file.0000001`, `file.0000002`, and so on.

The following is an EventBridge sample event for a job with a `COMPLETE` status. It includes output file path information for a file group with a frame capture output. 

```
{
    "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"
    ]
}
```

**Note**  
Quality-Defined Variable Bitrate (QVBR) statistics are only available when your video output uses QVBR rate control.

# Apple HLS group
Apple HLS group

The following is an Amazon EventBridge sample event for a job with a `COMPLETE` status. It includes output file path information for an Apple HLS group.

```
{
    "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"
    ]
}
```

**Note**  
Quality-Defined Variable Bitrate (QVBR) statistics are only available when your video output uses QVBR rate control.

# DASH ISO group
DASH ISO group

The following is an Amazon EventBridge sample event for a job with a `COMPLETE` status. It includes output file path information for a DASH ISO group.

```
{
    "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"
    ]
}
```

**Note**  
Quality-Defined Variable Bitrate (QVBR) statistics are only available when your video output uses QVBR rate control.

# CMAF group
CMAF group

The following is an EventBridge sample event for a job with a `COMPLETE` status. It includes output file path information for a CMAF group.

```
{
    "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"
    ]
}
```

**Note**  
Quality-Defined Variable Bitrate (QVBR) statistics are only available when your video output uses QVBR rate control.

# Microsoft Smooth Streaming group
Microsoft Smooth Streaming group

The following is an EventBridge sample event for a job with a `COMPLETE` status. It includes output file path information for a Microsoft Smooth Streaming group.

```
{
    "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"
    ]
}
```

**Note**  
Quality-Defined Variable Bitrate (QVBR) statistics are only available when your video output uses QVBR rate control.