Skip to content

PrefetchRetrieval

Source code in docs_src/capo_mediatailor/types/prefetch_retrieval.py
class PrefetchRetrieval(TypedDict, closed=True):
    dynamic_variables: NotRequired[
        "capo_mediatailor.types.__map_of__string.__mapOf__string"
    ]
    """<p>The dynamic variables to use for substitution during prefetch requests to the ad decision server (ADS).</p> <p>You initially configure <a href="https://docs.aws.amazon.com/mediatailor/latest/ug/variables.html">dynamic variables</a> for the ADS URL when you set up your playback configuration. When you specify <code>DynamicVariables</code> for prefetch retrieval, MediaTailor includes the dynamic variables in the request to the ADS.</p>"""
    end_time: "capo_mediatailor.types.__timestamp_unix.__timestampUnix"
    """<p>The time when prefetch retrieval ends for the ad break. Prefetching will be attempted for manifest requests that occur at or before this time.</p>"""
    start_time: NotRequired["capo_mediatailor.types.__timestamp_unix.__timestampUnix"]
    """<p>The time when prefetch retrievals can start for this break. Ad prefetching will be attempted for manifest requests that occur at or after this time. Defaults to the current time. If not specified, the prefetch retrieval starts as soon as possible.</p>"""
    traffic_shaping_type: NotRequired[
        "capo_mediatailor.types.traffic_shaping_type.TrafficShapingType"
    ]
    """<p>Indicates the type of traffic shaping used to limit the number of requests to the ADS at one time.</p>"""
    traffic_shaping_retrieval_window: NotRequired[
        "capo_mediatailor.types.traffic_shaping_retrieval_window.TrafficShapingRetrievalWindow"
    ]
    """<p>The configuration that tells Elemental MediaTailor how many seconds to spread out requests to the ad decision server (ADS). Instead of sending ADS requests for all sessions at the same time, MediaTailor spreads the requests across the amount of time specified in the retrieval window.</p>"""
    traffic_shaping_tps_configuration: NotRequired[
        "capo_mediatailor.types.traffic_shaping_tps_configuration.TrafficShapingTpsConfiguration"
    ]
    """<p>The configuration for TPS-based traffic shaping. This approach limits requests to the ad decision server (ADS) based on transactions per second and concurrent users.</p>"""

dynamic_variables instance-attribute

dynamic_variables: NotRequired[__mapOf__string]

The dynamic variables to use for substitution during prefetch requests to the ad decision server (ADS).

You initially configure dynamic variables for the ADS URL when you set up your playback configuration. When you specify DynamicVariables for prefetch retrieval, MediaTailor includes the dynamic variables in the request to the ADS.

end_time instance-attribute

end_time: __timestampUnix

The time when prefetch retrieval ends for the ad break. Prefetching will be attempted for manifest requests that occur at or before this time.

start_time instance-attribute

start_time: NotRequired[__timestampUnix]

The time when prefetch retrievals can start for this break. Ad prefetching will be attempted for manifest requests that occur at or after this time. Defaults to the current time. If not specified, the prefetch retrieval starts as soon as possible.

traffic_shaping_retrieval_window instance-attribute

traffic_shaping_retrieval_window: NotRequired[TrafficShapingRetrievalWindow]

The configuration that tells Elemental MediaTailor how many seconds to spread out requests to the ad decision server (ADS). Instead of sending ADS requests for all sessions at the same time, MediaTailor spreads the requests across the amount of time specified in the retrieval window.

traffic_shaping_tps_configuration instance-attribute

traffic_shaping_tps_configuration: NotRequired[TrafficShapingTpsConfiguration]

The configuration for TPS-based traffic shaping. This approach limits requests to the ad decision server (ADS) based on transactions per second and concurrent users.

traffic_shaping_type instance-attribute

traffic_shaping_type: NotRequired[TrafficShapingType]

Indicates the type of traffic shaping used to limit the number of requests to the ADS at one time.