MediaTailor query parameter handling for origins
AWS Elemental MediaTailor handles query parameters differently depending on their purpose. Manifest
query parameters (prefixed with manifest.
) are used for CDN routing and
authorization, while other query parameters can be used for origin-specific
functionality.
Time-shifted viewing with MediaPackage
For time-shifted viewing functionality with MediaPackage, you can include
start
and end
parameters in your requests. These
parameters define specific content windows for startover and catch-up
viewing.
Example time-shifted viewing request
Include start and end parameters in your manifest request for time-shifted viewing:
GET /v1/master/
111122223333
/originId
/index.m3u8?start=2024-08-26T10:00:00Z&end=2024-08-26T11:00:00Z
Parameter behavior during sessions
Query parameters are processed at session initialization. For time-shifted viewing or other origin-specific features:
-
Session initialization: Include required parameters with the initial manifest request
-
Parameter persistence: Parameters are associated with the session and maintained throughout playback
-
Changing parameters: To modify time-shift windows or other parameters, create a new session with updated values
Important
The specific handling of query parameters depends on your origin configuration and the parameters your content origin supports. For MediaPackage integration, ensure your CDN is configured to forward the necessary query parameters as described in Configure essential query parameters.