AWS cli documentation change
Summary
Updated AWS CLI version references. Enhanced Clear Lead DRM documentation to allow specifying number of unencrypted segments instead of binary enable/disable. Expanded trick play image generation with new 'VARIANTS' option and added 'ImageBasedTrickPlayVariants' structure for custom configurations. Updated constraints for thumbnail and tile settings.
Security assessment
The Clear Lead DRM changes document a security feature that reduces video startup latency through controlled unencrypted segments while maintaining content protection. However, there's no evidence this addresses a specific vulnerability. The rest are non-security feature enhancements for trick play generation.
Diff
diff --git a/cli/latest/reference/mediaconvert/get-jobs-query-results.md b/cli/latest/reference/mediaconvert/get-jobs-query-results.md index 7d9be4b5c..9c77413ff 100644 --- a//cli/latest/reference/mediaconvert/get-jobs-query-results.md +++ b//cli/latest/reference/mediaconvert/get-jobs-query-results.md @@ -15 +15 @@ - * [AWS CLI 2.34.61 Command Reference](../../index.html) » + * [AWS CLI 2.34.63 Command Reference](../../index.html) » @@ -4946 +4946 @@ Jobs -> (list) ->>>>>>>> ClearLead -> (string) +>>>>>>>> ClearLeadSegments -> (integer) @@ -4948 +4948 @@ Jobs -> (list) ->>>>>>>>> Enable Clear Lead DRM to reduce video startup latency by leaving the first segment unencrypted while DRM license retrieval occurs in parallel. This optimization allows immediate playback startup while maintaining content protection for the remainder of the stream. When enabled, the first output segment remains fully unencrypted, and encryption begins at the start of the second segment. The HLS manifest will omit #EXT-X-KEY tags during the clear segment and insert the first #EXT-X-KEY immediately before the first encrypted fragment. This feature is supported exclusively for CMAF HLS (fMP4) outputs and is compatible with all existing key provider integrations (SPEKE v1, SPEKE v2, and Static Key encryption). Supported codecs: H.264, H.265, and AV1 video codecs, and AAC audio codec. Choose Enabled to activate Clear Lead DRM optimization. Choose Disabled to use standard encryption where all segments are encrypted from the beginning. +>>>>>>>>> Reduce video startup latency by leaving initial segments unencrypted while DRM license retrieval occurs in parallel. This optimization allows immediate playback startup while maintaining content protection for the remainder of the stream. Specify the number of initial segments to leave unencrypted. Omit this field to disable Clear Lead. The HLS manifest will omit #EXT-X-KEY tags during clear segments and insert the first #EXT-X-KEY immediately before the first encrypted segment. Because encryption is applied at the fragment level, the actual duration of unencrypted content may be slightly longer than expected if the segment length is not evenly divisible by the fragment length. In such cases, encryption begins at the next fragment boundary after the specified clear lead segments, rather than at the exact segment boundary. This feature is supported exclusively for CMAF HLS (fMP4) outputs and is compatible with all existing key provider integrations (SPEKE v1, SPEKE v2, and Static Key encryption). Supported codecs: H.264, H.265, and AV1 video codecs, and AAC audio codec. @@ -4950 +4950 @@ Jobs -> (list) ->>>>>>>>> Possible values: +>>>>>>>>> Constraints: @@ -4952,2 +4952,2 @@ Jobs -> (list) ->>>>>>>>> * `ENABLED` ->>>>>>>>> * `DISABLED` +>>>>>>>>> * min: `1` +>>>>>>>>> * max: `9999` @@ -5152 +5152 @@ Jobs -> (list) ->>>>>>>> Specify whether MediaConvert generates images for trick play. Keep the default value, None, to not generate any images. Choose Thumbnail to generate tiled thumbnails. Choose Thumbnail and full frame to generate tiled thumbnails and full-resolution images of single frames. When you enable Write HLS manifest, MediaConvert creates a child manifest for each set of images that you generate and adds corresponding entries to the parent manifest. When you enable Write DASH manifest, MediaConvert adds an entry in the .mpd manifest for each set of images that you generate. A common application for these images is Roku trick mode. The thumbnails and full-frame images that MediaConvert creates with this feature are compatible with this Roku specification: <https://developer.roku.com/docs/developer-program/media-playback/trick-mode/hls-and-dash.md> +>>>>>>>> Specify whether MediaConvert generates images for trick play. Keep the default value, None, to not generate any images. Choose Thumbnail to generate tiled thumbnails. Choose Thumbnail and full frame to generate tiled thumbnails and full-resolution images of single frames. Choose Advanced to customize thumbnail and tile settings for a single trick play variant. Choose Variants to specify multiple trick play variants, each with its own thumbnail and tile settings. When you enable Write HLS manifest, MediaConvert creates a child manifest for each set of images that you generate and adds corresponding entries to the parent manifest. When you enable Write DASH manifest, MediaConvert adds an entry in the .mpd manifest for each set of images that you generate. A common application for these images is Roku trick mode. The thumbnails and full-frame images that MediaConvert creates with this feature are compatible with this Roku specification: <https://developer.roku.com/docs/developer-program/media-playback/trick-mode/hls-and-dash.md> @@ -5159,0 +5160 @@ Jobs -> (list) +>>>>>>>> * `VARIANTS` @@ -5207 +5208 @@ Jobs -> (list) ->>>>>>>>> Number of thumbnails in each column of a tile image. Set a value between 2 and 2048. Must be divisible by 2. +>>>>>>>>> Number of thumbnails in each column of a tile image. Set a value between 1 and 2048. @@ -5225,0 +5227,68 @@ Jobs -> (list) +>>>>>>> +>>>>>>> ImageBasedTrickPlayVariants -> (list) +>>>>>>> +>>>>>>>> Specify multiple image-based trick play variants. Each entry creates a separate set of JPEG tile images with its own resolution, tile layout, and cadence settings. Set imageBasedTrickPlay to VARIANTS when using this setting. +>>>>>>>> +>>>>>>>> (structure) +>>>>>>>> +>>>>>>>>> Settings for one image-based trick play variant. Each variant produces its own set of JPEG tile images and corresponding manifest entries. +>>>>>>>>> +>>>>>>>>> IntervalCadence -> (string) +>>>>>>>>> +>>>>>>>>>> The cadence MediaConvert follows for generating thumbnails. If set to FOLLOW_IFRAME, MediaConvert generates thumbnails for each IDR frame in the output (matching the GOP cadence). If set to FOLLOW_CUSTOM, MediaConvert generates thumbnails according to the interval you specify in thumbnailInterval. If set to FOLLOW_SEGMENTATION, MediaConvert generates thumbnail playlist entries that align exactly with video segment boundaries. FOLLOW_SEGMENTATION requires 1x1 tiling. +>>>>>>>>>> +>>>>>>>>>> Possible values: +>>>>>>>>>> +>>>>>>>>>> * `FOLLOW_IFRAME` +>>>>>>>>>> * `FOLLOW_CUSTOM` +>>>>>>>>>> * `FOLLOW_SEGMENTATION` +>>>>>>>>>> + +>>>>>>>>> +>>>>>>>>> ThumbnailHeight -> (integer) +>>>>>>>>> +>>>>>>>>>> Height of each thumbnail within each tile image, in pixels. Leave blank to maintain aspect ratio with thumbnail width. If following the aspect ratio would lead to a total tile height greater than 4096, then the job will be rejected. Must be divisible by 2. +>>>>>>>>>> +>>>>>>>>>> Constraints: +>>>>>>>>>> +>>>>>>>>>> * min: `2` +>>>>>>>>>> * max: `4096` +>>>>>>>>>> + +>>>>>>>>> +>>>>>>>>> ThumbnailInterval -> (double) +>>>>>>>>> +>>>>>>>>>> Enter the interval, in seconds, that MediaConvert uses to generate thumbnails. If the interval you enter doesn’t align with the output frame rate, MediaConvert automatically rounds the interval to align with the output frame rate. For example, if the output frame rate is 29.97 frames per second and you enter 5, MediaConvert uses a 150 frame interval to generate thumbnails. +>>>>>>>>> +>>>>>>>>> ThumbnailWidth -> (integer) +>>>>>>>>> +>>>>>>>>>> Width of each thumbnail within each tile image, in pixels. Default is 312. Must be divisible by 8. +>>>>>>>>>> +>>>>>>>>>> Constraints: +>>>>>>>>>> +>>>>>>>>>> * min: `8` +>>>>>>>>>> * max: `4096` +>>>>>>>>>> + +>>>>>>>>> +>>>>>>>>> TileHeight -> (integer) +>>>>>>>>> +>>>>>>>>>> Number of thumbnails in each column of a tile image. Set a value between 1 and 2048. +>>>>>>>>>> +>>>>>>>>>> Constraints: +>>>>>>>>>> +>>>>>>>>>> * min: `1` +>>>>>>>>>> * max: `2048` +>>>>>>>>>> + +>>>>>>>>> +>>>>>>>>> TileWidth -> (integer) +>>>>>>>>> +>>>>>>>>>> Number of thumbnails in each row of a tile image. Set a value between 1 and 512. +>>>>>>>>>> +>>>>>>>>>> Constraints: +>>>>>>>>>> +>>>>>>>>>> * min: `1` +>>>>>>>>>> * max: `512` +>>>>>>>>>> + @@ -5672 +5741 @@ Jobs -> (list) ->>>>>>>> Specify whether MediaConvert generates images for trick play. Keep the default value, None, to not generate any images. Choose Thumbnail to generate tiled thumbnails. Choose Thumbnail and full frame to generate tiled thumbnails and full-resolution images of single frames. MediaConvert adds an entry in the .mpd manifest for each set of images that you generate. A common application for these images is Roku trick mode. The thumbnails and full-frame images that MediaConvert creates with this feature are compatible with this Roku specification: <https://developer.roku.com/docs/developer-program/media-playback/trick-mode/hls-and-dash.md> +>>>>>>>> Specify whether MediaConvert generates images for trick play. Keep the default value, None, to not generate any images. Choose Thumbnail to generate tiled thumbnails. Choose Thumbnail and full frame to generate tiled thumbnails and full-resolution images of single frames. Choose Advanced to customize thumbnail and tile settings for a single trick play variant. Choose Variants to specify multiple trick play variants, each with its own thumbnail and tile settings. MediaConvert adds an entry in the .mpd manifest for each set of images that you generate. A common application for these images is Roku trick mode. The thumbnails and full-frame images that MediaConvert creates with this feature are compatible with this Roku specification: <https://developer.roku.com/docs/developer-program/media-playback/trick-mode/hls-and-dash.md> @@ -5679,0 +5749 @@ Jobs -> (list) +>>>>>>>> * `VARIANTS` @@ -5727 +5797 @@ Jobs -> (list) ->>>>>>>>> Number of thumbnails in each column of a tile image. Set a value between 2 and 2048. Must be divisible by 2. +>>>>>>>>> Number of thumbnails in each column of a tile image. Set a value between 1 and 2048. @@ -5745,0 +5816,68 @@ Jobs -> (list) +>>>>>>> +>>>>>>> ImageBasedTrickPlayVariants -> (list) +>>>>>>> +>>>>>>>> Specify multiple image-based trick play variants. Each entry creates a separate set of JPEG tile images with its own resolution, tile layout, and cadence settings. Set imageBasedTrickPlay to VARIANTS when using this setting. +>>>>>>>> +>>>>>>>> (structure) +>>>>>>>> +>>>>>>>>> Settings for one image-based trick play variant. Each variant produces its own set of JPEG tile images and corresponding manifest entries. +>>>>>>>>> +>>>>>>>>> IntervalCadence -> (string) +>>>>>>>>> +>>>>>>>>>> The cadence MediaConvert follows for generating thumbnails. If set to FOLLOW_IFRAME, MediaConvert generates thumbnails for each IDR frame in the output (matching the GOP cadence). If set to FOLLOW_CUSTOM, MediaConvert generates thumbnails according to the interval you specify in thumbnailInterval. If set to FOLLOW_SEGMENTATION, MediaConvert generates thumbnail playlist entries that align exactly with video segment boundaries. FOLLOW_SEGMENTATION requires 1x1 tiling. +>>>>>>>>>> +>>>>>>>>>> Possible values: +>>>>>>>>>> +>>>>>>>>>> * `FOLLOW_IFRAME` +>>>>>>>>>> * `FOLLOW_CUSTOM` +>>>>>>>>>> * `FOLLOW_SEGMENTATION` +>>>>>>>>>> + +>>>>>>>>> +>>>>>>>>> ThumbnailHeight -> (integer) +>>>>>>>>> +>>>>>>>>>> Height of each thumbnail within each tile image, in pixels. Leave blank to maintain aspect ratio with thumbnail width. If following the aspect ratio would lead to a total tile height greater than 4096, then the job will be rejected. Must be divisible by 2. +>>>>>>>>>> +>>>>>>>>>> Constraints: +>>>>>>>>>> +>>>>>>>>>> * min: `2` +>>>>>>>>>> * max: `4096` +>>>>>>>>>> + +>>>>>>>>> +>>>>>>>>> ThumbnailInterval -> (double) +>>>>>>>>> +>>>>>>>>>> Enter the interval, in seconds, that MediaConvert uses to generate thumbnails. If the interval you enter doesn’t align with the output frame rate, MediaConvert automatically rounds the interval to align with the output frame rate. For example, if the output frame rate is 29.97 frames per second and you enter 5, MediaConvert uses a 150 frame interval to generate thumbnails. +>>>>>>>>> +>>>>>>>>> ThumbnailWidth -> (integer) +>>>>>>>>> +>>>>>>>>>> Width of each thumbnail within each tile image, in pixels. Default is 312. Must be divisible by 8. +>>>>>>>>>> +>>>>>>>>>> Constraints: +>>>>>>>>>> +>>>>>>>>>> * min: `8` +>>>>>>>>>> * max: `4096` +>>>>>>>>>> + +>>>>>>>>> +>>>>>>>>> TileHeight -> (integer) +>>>>>>>>> +>>>>>>>>>> Number of thumbnails in each column of a tile image. Set a value between 1 and 2048. +>>>>>>>>>> +>>>>>>>>>> Constraints: +>>>>>>>>>> +>>>>>>>>>> * min: `1` +>>>>>>>>>> * max: `2048` +>>>>>>>>>> + +>>>>>>>>> +>>>>>>>>> TileWidth -> (integer) +>>>>>>>>> +>>>>>>>>>> Number of thumbnails in each row of a tile image. Set a value between 1 and 512. +>>>>>>>>>> +>>>>>>>>>> Constraints: +>>>>>>>>>> +>>>>>>>>>> * min: `1` +>>>>>>>>>> * max: `512` +>>>>>>>>>> + @@ -6560 +6698 @@ Jobs -> (list) ->>>>>>>> Specify whether MediaConvert generates images for trick play. Keep the default value, None, to not generate any images. Choose Thumbnail to generate tiled thumbnails. Choose Thumbnail and full frame to generate tiled thumbnails and full-resolution images of single frames. MediaConvert creates a child manifest for each set of images that you generate and adds corresponding entries to the parent manifest. A common application for these images is Roku trick mode. The thumbnails and full-frame images that MediaConvert creates with this feature are compatible with this Roku specification: <https://developer.roku.com/docs/developer-program/media-playback/trick-mode/hls-and-dash.md> +>>>>>>>> Specify whether MediaConvert generates images for trick play. Keep the default value, None, to not generate any images. Choose Thumbnail to generate tiled thumbnails. Choose Thumbnail and full frame to generate tiled thumbnails and full-resolution images of single frames. Choose Advanced to customize thumbnail and tile settings for a single trick play variant. Choose Variants to specify multiple trick play variants, each with its own thumbnail and tile settings. MediaConvert creates a child manifest for each set of images that you generate and adds corresponding entries to the parent manifest. A common application for these images is Roku trick mode. The thumbnails and full-frame images that MediaConvert creates with this feature are compatible with this Roku specification: <https://developer.roku.com/docs/developer-program/media-playback/trick-mode/hls-and-dash.md> @@ -6567,0 +6706 @@ Jobs -> (list) +>>>>>>>> * `VARIANTS` @@ -6615 +6754 @@ Jobs -> (list) ->>>>>>>>> Number of thumbnails in each column of a tile image. Set a value between 2 and 2048. Must be divisible by 2. +>>>>>>>>> Number of thumbnails in each column of a tile image. Set a value between 1 and 2048. @@ -6633,0 +6773,68 @@ Jobs -> (list) +>>>>>>> +>>>>>>> ImageBasedTrickPlayVariants -> (list) +>>>>>>> +>>>>>>>> Specify multiple image-based trick play variants. Each entry creates a separate set of JPEG tile images with its own resolution, tile layout, and cadence settings. Set imageBasedTrickPlay to VARIANTS when using this setting. +>>>>>>>> +>>>>>>>> (structure) +>>>>>>>> +>>>>>>>>> Settings for one image-based trick play variant. Each variant produces its own set of JPEG tile images and corresponding manifest entries. +>>>>>>>>> +>>>>>>>>> IntervalCadence -> (string) +>>>>>>>>> +>>>>>>>>>> The cadence MediaConvert follows for generating thumbnails. If set to FOLLOW_IFRAME, MediaConvert generates thumbnails for each IDR frame in the output (matching the GOP cadence). If set to FOLLOW_CUSTOM, MediaConvert generates thumbnails according to the interval you specify in thumbnailInterval. If set to FOLLOW_SEGMENTATION, MediaConvert generates thumbnail playlist entries that align exactly with video segment boundaries. FOLLOW_SEGMENTATION requires 1x1 tiling. +>>>>>>>>>> +>>>>>>>>>> Possible values: +>>>>>>>>>> +>>>>>>>>>> * `FOLLOW_IFRAME`