GetPrefetchSchedule - AWS Elemental MediaTailor

GetPrefetchSchedule

Retrieves a prefetch schedule for a playback configuration. A prefetch schedule allows you to tell MediaTailor to fetch and prepare certain ads before an ad break happens. For more information about ad prefetching, see Using ad prefetching in the MediaTailor User Guide.

Request Syntax

GET /prefetchSchedule/PlaybackConfigurationName/Name HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

Name

The name of the prefetch schedule. The name must be unique among all prefetch schedules that are associated with the specified playback configuration.

Required: Yes

PlaybackConfigurationName

Returns information about the prefetch schedule for a specific playback configuration. If you call GetPrefetchSchedule on an expired prefetch schedule, MediaTailor returns an HTTP 404 status code.

Required: Yes

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "Arn": "string", "Consumption": { "AvailMatchingCriteria": [ { "DynamicVariable": "string", "Operator": "string" } ], "EndTime": number, "StartTime": number }, "Name": "string", "PlaybackConfigurationName": "string", "Retrieval": { "DynamicVariables": { "string" : "string" }, "EndTime": number, "StartTime": number }, "StreamId": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

Arn

The Amazon Resource Name (ARN) of the prefetch schedule.

Type: String

Consumption

Consumption settings determine how, and when, MediaTailor places the prefetched ads into ad breaks. Ad consumption occurs within a span of time that you define, called a consumption window. You can designate which ad breaks that MediaTailor fills with prefetch ads by setting avail matching criteria.

Type: PrefetchConsumption object

Name

The name of the prefetch schedule. The name must be unique among all prefetch schedules that are associated with the specified playback configuration.

Type: String

PlaybackConfigurationName

The name of the playback configuration to create the prefetch schedule for.

Type: String

Retrieval

A complex type that contains settings for prefetch retrieval from the ad decision server (ADS).

Type: PrefetchRetrieval object

StreamId

An optional stream identifier that you can specify in order to prefetch for multiple streams that use the same playback configuration.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: