Manifest filter query parameters in AWS Elemental MediaPackage - AWS Elemental MediaPackage

Manifest filter query parameters in AWS Elemental MediaPackage

MediaPackage supports the following query parameters.

Category Name Description Example
Audio audio_bitrate

  • The audio bitrate in bits per second.

  • Accepted values: Two integers aggregated with a dash that define an inclusive range. The supported range values are 0 - 2147483647.

 stream.mpd?aws.manifestfilter=audio_bitrate:0-2147483647
Audio audio_channels

  • The number of audio channels.

  • Accepted values: Two integers aggregated with a dash that define an inclusive range. The supported range values are 1 - 32767.

 stream.mpd?aws.manifestfilter=audio_channels:1-8
Audio audio_codec

  • The audio codec type.

  • Accepted values: AACL, AACH, AC-3, EC-3. You must include the - for AC-3 and EC-3.

    The values are not case-sensitive.

 stream.mpd?aws.manifestfilter=audio_codec:AACL,AC-3
Audio audio_language

  • Audio languages or functional codes derived from encoder passthrough.

  • Accepted values: Arbitrary strings, such as two or four character ISO-639-1 language codes. You must use the same language strings that are set for your encoder.

    The values are not case-sensitive.

 stream.mpd?aws.manifestfilter=audio_language:fr,en-US,de
Audio audio_sample_rate

  • The audio sample rate in Hz.

  • Accepted values: Two integers aggregated with a dash that define an inclusive range. The supported range values are 0 - 2147483647.

 stream.mpd?aws.manifestfilter=audio_sample_rate:0-44100
Subtitle subtitle_language

  • The subtitle language or functional codes derived from encoder passthrough.

  • Accepted values: Arbitrary strings, such as two or four character ISO-639-1 language codes. You must use the same language strings that are set for your encoder.

    The values are not case-sensitive.

 stream.mpd?aws.manifestfilter=subtitle_language:en-US, hi
Video trickplay_height

  • The height of the trick-play image in pixels. This applies to both I-frame only and image-based trick-play.

    Note

    If you're using this parameter with I-frame only trick-play, trickplay_height and video_height should have similar values. If the values are not the same, I-frame only tracks might be removed from a manifest.

  • Accepted values: Two integers aggregated with a dash that define an inclusive range. The supported range values are 1 - 2147483647.

 stream.mpd?aws.manifestfilter=trickplay_height:200-1200
Video trickplay_type

  • The trickplay track type.

  • Accepted values: iframe, image, none.

    The values are not case-sensitive.

 stream.mpd?aws.manifestfilter=trickplay_type:iframe
Video video_bitrate

  • The video bitrate in bits per second.

    Note

    If you're using this parameter, we recommend that you use only the video_bitrate filter parameter to set the video bitrate. Don't also set the minimum and maximum video bitrate via the MediaPackage console or AWS CLI. The video_bitrate filter applies to the video bitrate settings created at the endpoint. If you use the parameter and set the bitrate in the console or AWS CLI, your output might be skewed.

  • Accepted values: Two integers aggregated with a dash that define an inclusive range. The supported range values are 0 - 2147483647.

  • Note

    You can't use this parameter with trick-play streams.

 stream.mpd?aws.manifestfilter=video_bitrate:0-2147483647
Video video_codec

  • The video codec type.

  • Accepted values: H264, H265, AV1.

    The values are not case-sensitive.

 stream.mpd?aws.manifestfilter=video_codec:h264
Video video_dynamic_range

  • The video dynamic range.

  • Accepted values: dv, hdr10, hlg, sdr.

    The values are not case-sensitive.

    You can use the dv value to filter for Dolby Vision streams.

 stream.mpd?aws.manifestfilter=video_dynamic_range:hdr10
Video video_framerate

  • The video frame rate range in the NTSC format.

  • Accepted values: Two floating-point numbers aggregated with a dash that define an inclusive range. Each number can have up to three optional fractional values. For example, 29.97 or 29.764. The supported range values are 1 - 999.999.

 stream.mpd?aws.manifestfilter=video_framerate:23.976-30
Video video_height

  • The height of the video in pixels.

    Note

    If you're using this parameter with I-frame only trick-play, trickplay_height and video_height should have similar values. If the values are not the same, I-frame only tracks might be removed from a manifest.

  • Accepted values: Two integers aggregated with a dash that define an inclusive range. The supported range values are 1 - 32767.

 stream.mpd?aws.manifestfilter=video_height:720-1080
Note

When configuring Manifest filters as part of the Filter Configuration for your endpoint, be aware that using corresponding query parameters in the manifest's endpoint URL can lead to issues. Specifically, if you include a Manifest filter in your Filter Configuration and then attempt to use matching query parameters in the endpoint URL, you will encounter a 404 HTTP error code. For example, if your Filter Configuration includes a Manifest filter with an audio_sample_rate key set to 44100, and you subsequently make an HTTP request to https://<example-url>/?aws.manifestfilter=audio_sample_rate:44100 this will result in a 404 error. The Filter Configuration applies universally to all egress requests for your endpoint, and duplicating these settings in the URL query can lead to conflicts and errors. For more information about Manifest filters, see Manifest filtering from AWS Elemental MediaPackage.