Amazon Interactive Video Service

2026/10/28 - Amazon Interactive Video Service - 1 updated api methods

Changes  InsertAdBreak now allows setting a customized adBreakId on a request and also adds a new field targetStartAt for a delayed ad insertion

InsertAdBreak (updated) Link ΒΆ
Changes (request, response)
Request
{'adBreakId': 'string', 'targetStartAt': 'timestamp'}
Response
{'targetStartAt': 'timestamp'}

Inserts an ad marker in the playlist for the specified channel and duration using the ad configuration associated with the channel.

Note: AWS Elemental MediaTailor (EMT), the service that handles ad requests, provides CloudWatch metrics to help you monitor the success or failure of each InsertAdBreak operation. See Monitoring AWS Elemental MediaTailor with Amazon CloudWatch metrics in the AWS Elemental MediaTailor User Guide for details on available metrics.

See also: AWS API Documentation

Request Syntax

client.insert_ad_break(
    channelArn='string',
    durationSeconds=123,
    adBreakId='string',
    targetStartAt=datetime(2015, 1, 1)
)
type channelArn:

string

param channelArn:

[REQUIRED]

ARN of the channel into which the ad break is inserted.

type durationSeconds:

integer

param durationSeconds:

[REQUIRED]

Duration of the ad break, in seconds.

type adBreakId:

string

param adBreakId:

Caller-specified unique identifier for the ad break to insert into the playlist.

type targetStartAt:

datetime

param targetStartAt:

Target time at which the ad break starts.

rtype:

dict

returns:

Response Syntax

{
    'adBreakId': 'string',
    'targetStartAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • adBreakId (string) --

      Unique identifier for the ad break that was inserted into the playlist.

    • targetStartAt (datetime) --

      Target start time for the inserted ad break.