AWS mediaconvert documentation change
Summary
Restructured warning code documentation with expanded explanations, recommended actions, and clearer formatting for each warning code
Security assessment
The changes improve documentation clarity and add troubleshooting guidance for various media processing warnings, but do not address security vulnerabilities or introduce security features. All warnings relate to media encoding technical limitations and input/output handling rather than security controls.
Diff
diff --git a/mediaconvert/latest/ug/warning_codes.md b/mediaconvert/latest/ug/warning_codes.md index 84e8a94d8..021d33317 100644 --- a//mediaconvert/latest/ug/warning_codes.md +++ b//mediaconvert/latest/ug/warning_codes.md @@ -9,21 +9,370 @@ AWS Elemental MediaConvert returns warning codes when transcoding jobs run into -This table provides detailed information about the warning codes that MediaConvert returns, including possible causes and solutions. - -Warning code | Message | Details ----|---|--- -100000 | Your job couldn't hop from its original submission queue to its destination queue. | Your job waited in its original submission queue for longer than the wait time that you specified, but it couldn’t move to its new destination queue. Check whether your destination queue still exists. No action is required, but your job may take longer than you expect to complete. You control hop behavior, including `Wait minutes` and the `Destination queue`, under the **Job management Queue hopping** settings. For more information, see `HopDestination` in the [API Reference](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-model-hopdestination). -220000 | Your input file is truncated. | Your input file is missing data and your output's duration may be shorter than you expect. To troubleshoot, check your input for missing content. -230001 | Your input's color metadata is missing or incomplete. | MediaConvert could not follow your input's color space because your input has missing or incomplete color metadata. Color metadata includes color primaries, transfer function, and matrix coefficients. Your output might have missing or inaccurate color metadata which can cause players to inaccurately display the video contents. If you specified `Color space conversion` in the output `Color corrector`, note that MediaConvert could not convert the color space and may have written inaccurate color metadata. To resolve, manually specify your input's `Color space` and set `Color space usage` to `Force`. For more information, see `ColorSpace` in the [API Reference](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-model-colorspace). -230002 | MediaConvert can't apply audio duration correction to your input. | There is something wrong with the `'stts'` time-to-sample table in your input file container's audio track, and MediaConvert can't apply audio duration correction. For more information about audio duration correction, see the [API Reference](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-model-audiodurationcorrection). Check your output for any audio video synchronization issues. -230004 | Your input is missing information in its `'mdhd'` media header atom. | The `'mdhd'` media header atom in your input is incomplete or is missing data. MediaConvert expects the `'mdhd'` atom to be 32 bytes or 20 bytes. MediaConvert may not read your input correctly. Check the accuracy and quality of your output, including the total file duration and any language codes. -230005 | MediaConvert can't find color sample range metadata in your input. | MediaConvert could not follow your input's color sample range because your input has missing or incomplete color sample range metadata. Your output might have missing or inaccurate color sample range metadata which can cause players to inaccurately display the video contents. If you specified `Color space conversion` or `Sample range conversion` in the output `Color corrector`, note that your output's sample range may be inaccurate. To resolve, manually specify your input's `Sample range`. For more information, see `SampleRange` in the [API Reference](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-model-inputsamplerange). -230006 | MediaConvert can’t decode a portion of your input audio. | There's something wrong with your input's file structure or audio stream. Check your input for corruption or other audio encoding issues. Your output may be missing audio content that MediaConvert could't decode. -230007 | Your fragmented MP4 input has MOOF fragments that are out of order. | When your input is a fragmented MP4, each MOOF fragment (Movie Fragment Box) should increment sequentially. If you receive this warning, your input may have a discontinuity. -230008 | MediaConvert can't decode a portion of your MP4 input's video stream. | Your MP4 input may have corrupt `NAL` units in the `AVC1` atom, and MediaConvert couldn't decode all of the video stream. Check your video output for issues, including problems with color, missing scene information, or gray frames, where MediaConvert couldn't decode the video stream. -240000 | MediaConvert added at least 100 milliseconds of audio silence to keep audio and video in sync. | Your input audio track has missing, corrupt, or unexpected data. Check your output for any audio video synchronization issues. -240001 | MediaConvert dropped at least 100 milliseconds of audio to align audio and video. | Check your output for any audio video synchronization issues. -240003 | MediaConvert converted your full range input into a limited range HDR10+ output. | You specified a full range HDR10+ output, but MediaConvert could only write it with a limited range. You can control how MediaConvert converts the color sample range by using the Color corrector preprocessor. Set Sample range conversion to Limited range squeeze or Limited range clip. -250001 | Your input captions have an unsupported font. | You submitted an input caption with an unsupported font. MediaConvert will use a generic font instead. -250002 | Your Dolby CBI input has an unsupported bitrate. | You submitted a Dolby CBI input with an unsupported bitrate. MediaConvert will increase it to a supported bitrate. Check that the application generating your DOLBY CBI input is currbent and up to date. -250003 | MediaConvert can't apply Saliency aware encoding to one or more of your outputs. | MediaConvert only applies Saliency aware encoding to outputs that are 720p or higher in resolution that use Single Pass HQ or Multi Pass HQ Quality tuning levels. Use Saliency aware encoding to improve the perceptual video quality of your output by allocating more encoding bits to the prominent or noticeable parts of your content. You will receive this warning for jobs that specify Saliency aware encoding for outputs lower than 720p in resolution or for Single pass outputs. You may also receive this warning message for jobs that specify Saliency aware encoding within an Automated ABR output, or for jobs that use certain Presets or Templates. This warning message is provided for informational purposes, and no action is required. -260000 | Your output transport stream exceeded the bitrate that you specified. | The bitrate that you specified for your output transport stream container is less than the maximum momentary bitrate of all of the output streams within it. This results in a video decoder buffer underflow. To resolve, either increase the container's bitrate, or decrease the bitrate for the video, audio, and data streams. Alternatively, you can set Prevent buffer underflow to Enabled, although this can result in reduced output video quality whenever MediaConvert prevents a decoder buffer underflow. -270000 | MediaConvert received a **`503 Slow Down`** error code from Amazon S3 while writing your output to your destination bucket. | While MediaConvert was writing your output files to your destination bucket, it was throttled by Amazon S3. Your job might stall or take longer than expected to complete. You receive a `503 Slow Down` error response when you exceed your request rate limit to Amazon S3. Check for any other applications that are making simultaneous requests and limit them. For more information, see [Troubleshooting Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/troubleshooting.html). +The following provides detailed information about warning codes and messages that MediaConvert returns, their possible causes, and solutions. To find information about a warning, you can quickly find the warning code using the following links. Details for each warning are available after the table. + +**Warning codes** + + +100000 | 220000 | 230001 | 230002 | 230004 | 230005 | 230006 | 230007 | 230008 | 240000 | 240001 | 240003 | 250001 | 250002 | 250003 | 260000 | 270000 + +The following is a list of warning codes and troubleshooting steps: + +** + +100000 | Queue hop warning** + + +What this means: Your job waited in its original submission queue for longer than the wait time that you specified, but it couldn't move to its new destination queue. This could be because the destination queue no longer exists or has been modified. + +You control hop behavior, including `Wait minutes` and the `Destination queue`, under the **Job management Queue hopping** settings. + +Recommended actions: + + * Check whether your destination queue still exists. + + * No immediate action is required, but your job might take longer than expected to complete. + + + + +For more information, see `HopDestination` in the [API Reference](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-model-hopdestination). + +Warning message: + +**`Your job couldn't hop from its original submission queue to its destination queue.`** + +** + +220000 | Input incomplete warning** + + +What this means: Your input file is missing data and your output's duration might be shorter than you expect. + +Recommended actions: + + * Check your input for missing content. + + * Verify that your file was completely uploaded to Amazon S3. + + * Try re-uploading the file if necessary. + + + + +Warning message: + +**`Your input file is truncated.`** + +** + +230001 | Input color metadata warning** + + +What this means: MediaConvert could not follow your input's color space because your input has missing or incomplete color metadata. Color metadata includes color primaries, transfer function, and matrix coefficients. + +Your output might have missing or inaccurate color metadata which can cause players to inaccurately display the video contents. If you specified `Color space conversion` in the output `Color corrector`, note that MediaConvert could not convert the color space and might have written inaccurate color metadata. + +Recommended actions: + + * Manually specify your input's `Color space` and set `Color space usage` to `Force`. + + * Check your output for color accuracy issues. + + + + +For more information, see `ColorSpace` in the [API Reference](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-model-colorspace). + +Warning message: + +**`Your input's color metadata is missing or incomplete.`** + +** + +230002 | Audio duration correction warning** + + +What this means: There is something wrong with the `'stts'` time-to-sample table in your input file container's audio track, and MediaConvert can't apply audio duration correction. + +Recommended actions: + + * Check your output for any audio video synchronization issues. + + + + +For more information about audio duration correction, see the [API Reference](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-model-audiodurationcorrection). + +Warning message: + +**`MediaConvert can't apply audio duration correction to your input.`** + +** + +230004 | Input media header warning** + + +What this means: The `'mdhd'` media header atom in your input is incomplete or is missing data. MediaConvert expects the `'mdhd'` atom to be 32 bytes or 20 bytes. + +MediaConvert might not read your input correctly, which could affect the quality or accuracy of your output. + +Recommended actions: + + * Check the accuracy and quality of your output, including the total file duration and any language codes. + + + + +Warning message: + +**`Your input is missing information in its`'mdhd'` media header atom.`** + +** + +230005 | Input color sample range warning** + + +What this means: MediaConvert could not follow your input's color sample range because your input has missing or incomplete color sample range metadata. + +Your output might have missing or inaccurate color sample range metadata which can cause players to inaccurately display the video contents. If you specified `Color space conversion` or `Sample range conversion` in the output `Color corrector`, note that your output's sample range might be inaccurate. + +Recommended actions: + + * Manually specify your input's `Sample range`. + + * Check your output for color accuracy issues. + + + + +For more information, see `SampleRange` in the [API Reference](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-model-inputsamplerange). + +Warning message: + +**`MediaConvert can't find color sample range metadata in your input.`** + +** + +230006 | Input audio warning** + + +What this means: There's something wrong with your input's file structure or audio stream. The file might be corrupted or use non-standard encoding settings. + +Your output might be missing audio content that MediaConvert couldn't decode. + +Recommended actions: + + * Check your input for corruption or other audio encoding issues. + + * Verify that your output contains all expected audio content. + + + + +Warning message: + +**`MediaConvert can't decode a portion of your input audio.`** + +** + +230007 | Input fragmented MP4 warning** + + +What this means: When your input is a fragmented MP4, each MOOF fragment (Movie Fragment Box) should increment sequentially. Your input has fragments that are out of order, which might cause playback issues. + +Recommended actions: +