AWS cli documentation change
Summary
Updated AWS CLI version reference and modified ClearLead DRM feature to ClearLeadSegments with integer input for unencrypted segments. Enhanced trick play options with new 'Variants' mode and added ImageBasedTrickPlayVariants settings structure.
Security assessment
The ClearLeadSegments change documents a security feature where initial segments remain unencrypted to reduce video startup latency while maintaining encryption for subsequent content. This is a documented security feature (DRM optimization), but there's no evidence of a vulnerability being addressed. The trick play changes are unrelated to security.
Diff
diff --git a/cli/latest/reference/mediaconvert/get-job-template.md b/cli/latest/reference/mediaconvert/get-job-template.md index f057620f9..de6bb6a8d 100644 --- a//cli/latest/reference/mediaconvert/get-job-template.md +++ b//cli/latest/reference/mediaconvert/get-job-template.md @@ -15 +15 @@ - * [AWS CLI 2.34.61 Command Reference](../../index.html) » + * [AWS CLI 2.34.63 Command Reference](../../index.html) » @@ -4599 +4599 @@ JobTemplate -> (structure) ->>>>>>> ClearLead -> (string) +>>>>>>> ClearLeadSegments -> (integer) @@ -4601 +4601 @@ JobTemplate -> (structure) ->>>>>>>> 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. @@ -4603 +4603 @@ JobTemplate -> (structure) ->>>>>>>> Possible values: +>>>>>>>> Constraints: @@ -4605,2 +4605,2 @@ JobTemplate -> (structure) ->>>>>>>> * `ENABLED` ->>>>>>>> * `DISABLED` +>>>>>>>> * min: `1` +>>>>>>>> * max: `9999` @@ -4805 +4805 @@ JobTemplate -> (structure) ->>>>>>> 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> @@ -4812,0 +4813 @@ JobTemplate -> (structure) +>>>>>>> * `VARIANTS` @@ -4860 +4861 @@ JobTemplate -> (structure) ->>>>>>>> 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. @@ -4878,0 +4880,68 @@ JobTemplate -> (structure) +>>>>>> +>>>>>> 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` +>>>>>>>>> + @@ -5325 +5394 @@ JobTemplate -> (structure) ->>>>>>> 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> @@ -5332,0 +5402 @@ JobTemplate -> (structure) +>>>>>>> * `VARIANTS` @@ -5380 +5450 @@ JobTemplate -> (structure) ->>>>>>>> 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. @@ -5398,0 +5469,68 @@ JobTemplate -> (structure) +>>>>>> +>>>>>> 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` +>>>>>>>>> + @@ -6213 +6351 @@ JobTemplate -> (structure) ->>>>>>> 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> @@ -6220,0 +6359 @@ JobTemplate -> (structure) +>>>>>>> * `VARIANTS` @@ -6268 +6407 @@ JobTemplate -> (structure) ->>>>>>>> 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. @@ -6286,0 +6426,68 @@ JobTemplate -> (structure) +>>>>>> +>>>>>> 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`