AWS CLI version 2, the latest major version of AWS CLI, is now stable and recommended for general use. To view this page for the AWS CLI version 2, click here. For more information see the AWS CLI version 2 installation instructions and migration guide.
[ aws . mediatailor ]
Creates a program within a channel. For information about programs, see Working with programs in the MediaTailor User Guide .
See also: AWS API Documentation
create-program
[--ad-breaks <value>]
[--audience-media <value>]
--channel-name <value>
[--live-source-name <value>]
--program-name <value>
--schedule-configuration <value>
--source-location-name <value>
[--vod-source-name <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
--ad-breaks
(list)
The ad break configuration settings.
(structure)
Ad break configuration parameters.
AdBreakMetadata -> (list)
Defines a list of key/value pairs that MediaTailor generates within the
EXT-X-ASSET
tag forSCTE35_ENHANCED
output.(structure)
For
SCTE35_ENHANCED
output, defines a key and corresponding value. MediaTailor generates these pairs within theEXT-X-ASSET
tag.Key -> (string)
ForSCTE35_ENHANCED
output, defines a key. MediaTailor takes this key, and its associated value, and generates the key/value pair within theEXT-X-ASSET
tag. If you specify a key, you must also specify a corresponding value.Value -> (string)
ForSCTE35_ENHANCED
output, defines a value. MediaTailor; takes this value, and its associated key, and generates the key/value pair within theEXT-X-ASSET
tag. If you specify a value, you must also specify a corresponding key.MessageType -> (string)
The SCTE-35 ad insertion type. Accepted value:SPLICE_INSERT
,TIME_SIGNAL
.OffsetMillis -> (long)
How long (in milliseconds) after the beginning of the program that an ad starts. This value must fall within 100ms of a segment boundary, otherwise the ad break will be skipped.Slate -> (structure)
Ad break slate configuration.
SourceLocationName -> (string)
The name of the source location where the slate VOD source is stored.VodSourceName -> (string)
The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate.SpliceInsertMessage -> (structure)
This defines the SCTE-35
splice_insert()
message inserted around the ad. For information about usingsplice_insert()
, see the SCTE-35 specficiaiton, section 9.7.3.1.AvailNum -> (integer)
This is written tosplice_insert.avail_num
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is0
. Values must be between0
and256
, inclusive.AvailsExpected -> (integer)
This is written tosplice_insert.avails_expected
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is0
. Values must be between0
and256
, inclusive.SpliceEventId -> (integer)
This is written tosplice_insert.splice_event_id
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is1
.UniqueProgramId -> (integer)
This is written tosplice_insert.unique_program_id
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is0
. Values must be between0
and256
, inclusive.TimeSignalMessage -> (structure)
Defines the SCTE-35
time_signal
message inserted around the ad.Programs on a channel's schedule can be configured with one or more ad breaks. You can attach a
splice_insert
SCTE-35 message to the ad break. This message provides basic metadata about the ad break.See section 9.7.4 of the 2022 SCTE-35 specification for more information.
SegmentationDescriptors -> (list)
The configurations for the SCTE-35
segmentation_descriptor
message(s) sent with thetime_signal
message.(structure)
The
segmentation_descriptor
message can contain advanced metadata fields, like content identifiers, to convey a wide range of information about the ad break. MediaTailor writes the ad metadata in the egress manifest as part of theEXT-X-DATERANGE
orEventStream
ad marker's SCTE-35 data.segmentation_descriptor
messages must be sent with thetime_signal
message type.See the
segmentation_descriptor()
table of the 2022 SCTE-35 specification for more information.SegmentNum -> (integer)
The segment number to assign to thesegmentation_descriptor.segment_num
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification Values must be between 0 and 256, inclusive. The default value is 0.SegmentationEventId -> (integer)
The Event Identifier to assign to thesegmentation_descriptor.segmentation_event_id
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. The default value is 1.SegmentationTypeId -> (integer)
The Type Identifier to assign to thesegmentation_descriptor.segmentation_type_id
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is 48.SegmentationUpid -> (string)
The Upid to assign to thesegmentation_descriptor.segmentation_upid
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. The value must be a hexadecimal string containing only the characters 0 though 9 and A through F. The default value is "" (an empty string).SegmentationUpidType -> (integer)
The Upid Type to assign to thesegmentation_descriptor.segmentation_upid_type
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is 14.SegmentsExpected -> (integer)
The number of segments expected, which is assigned to thesegmentation_descriptor.segments_expectedS
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification Values must be between 0 and 256, inclusive. The default value is 0.SubSegmentNum -> (integer)
The sub-segment number to assign to thesegmentation_descriptor.sub_segment_num
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The defualt value is null.SubSegmentsExpected -> (integer)
The number of sub-segments expected, which is assigned to thesegmentation_descriptor.sub_segments_expected
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is null.
JSON Syntax:
[
{
"AdBreakMetadata": [
{
"Key": "string",
"Value": "string"
}
...
],
"MessageType": "SPLICE_INSERT"|"TIME_SIGNAL",
"OffsetMillis": long,
"Slate": {
"SourceLocationName": "string",
"VodSourceName": "string"
},
"SpliceInsertMessage": {
"AvailNum": integer,
"AvailsExpected": integer,
"SpliceEventId": integer,
"UniqueProgramId": integer
},
"TimeSignalMessage": {
"SegmentationDescriptors": [
{
"SegmentNum": integer,
"SegmentationEventId": integer,
"SegmentationTypeId": integer,
"SegmentationUpid": "string",
"SegmentationUpidType": integer,
"SegmentsExpected": integer,
"SubSegmentNum": integer,
"SubSegmentsExpected": integer
}
...
]
}
}
...
]
--audience-media
(list)
The list of AudienceMedia defined in program.
(structure)
An AudienceMedia object contains an Audience and a list of AlternateMedia.
AlternateMedia -> (list)
The list of AlternateMedia defined in AudienceMedia.
(structure)
A playlist of media (VOD and/or live) to be played instead of the default media on a particular program.
AdBreaks -> (list)
Ad break configuration parameters defined in AlternateMedia.
(structure)
Ad break configuration parameters.
AdBreakMetadata -> (list)
Defines a list of key/value pairs that MediaTailor generates within the
EXT-X-ASSET
tag forSCTE35_ENHANCED
output.(structure)
For
SCTE35_ENHANCED
output, defines a key and corresponding value. MediaTailor generates these pairs within theEXT-X-ASSET
tag.Key -> (string)
ForSCTE35_ENHANCED
output, defines a key. MediaTailor takes this key, and its associated value, and generates the key/value pair within theEXT-X-ASSET
tag. If you specify a key, you must also specify a corresponding value.Value -> (string)
ForSCTE35_ENHANCED
output, defines a value. MediaTailor; takes this value, and its associated key, and generates the key/value pair within theEXT-X-ASSET
tag. If you specify a value, you must also specify a corresponding key.MessageType -> (string)
The SCTE-35 ad insertion type. Accepted value:SPLICE_INSERT
,TIME_SIGNAL
.OffsetMillis -> (long)
How long (in milliseconds) after the beginning of the program that an ad starts. This value must fall within 100ms of a segment boundary, otherwise the ad break will be skipped.Slate -> (structure)
Ad break slate configuration.
SourceLocationName -> (string)
The name of the source location where the slate VOD source is stored.VodSourceName -> (string)
The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate.SpliceInsertMessage -> (structure)
This defines the SCTE-35
splice_insert()
message inserted around the ad. For information about usingsplice_insert()
, see the SCTE-35 specficiaiton, section 9.7.3.1.AvailNum -> (integer)
This is written tosplice_insert.avail_num
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is0
. Values must be between0
and256
, inclusive.AvailsExpected -> (integer)
This is written tosplice_insert.avails_expected
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is0
. Values must be between0
and256
, inclusive.SpliceEventId -> (integer)
This is written tosplice_insert.splice_event_id
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is1
.UniqueProgramId -> (integer)
This is written tosplice_insert.unique_program_id
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is0
. Values must be between0
and256
, inclusive.TimeSignalMessage -> (structure)
Defines the SCTE-35
time_signal
message inserted around the ad.Programs on a channel's schedule can be configured with one or more ad breaks. You can attach a
splice_insert
SCTE-35 message to the ad break. This message provides basic metadata about the ad break.See section 9.7.4 of the 2022 SCTE-35 specification for more information.
SegmentationDescriptors -> (list)
The configurations for the SCTE-35
segmentation_descriptor
message(s) sent with thetime_signal
message.(structure)
The
segmentation_descriptor
message can contain advanced metadata fields, like content identifiers, to convey a wide range of information about the ad break. MediaTailor writes the ad metadata in the egress manifest as part of theEXT-X-DATERANGE
orEventStream
ad marker's SCTE-35 data.segmentation_descriptor
messages must be sent with thetime_signal
message type.See the
segmentation_descriptor()
table of the 2022 SCTE-35 specification for more information.SegmentNum -> (integer)
The segment number to assign to thesegmentation_descriptor.segment_num
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification Values must be between 0 and 256, inclusive. The default value is 0.SegmentationEventId -> (integer)
The Event Identifier to assign to thesegmentation_descriptor.segmentation_event_id
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. The default value is 1.SegmentationTypeId -> (integer)
The Type Identifier to assign to thesegmentation_descriptor.segmentation_type_id
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is 48.SegmentationUpid -> (string)
The Upid to assign to thesegmentation_descriptor.segmentation_upid
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. The value must be a hexadecimal string containing only the characters 0 though 9 and A through F. The default value is "" (an empty string).SegmentationUpidType -> (integer)
The Upid Type to assign to thesegmentation_descriptor.segmentation_upid_type
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is 14.SegmentsExpected -> (integer)
The number of segments expected, which is assigned to thesegmentation_descriptor.segments_expectedS
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification Values must be between 0 and 256, inclusive. The default value is 0.SubSegmentNum -> (integer)
The sub-segment number to assign to thesegmentation_descriptor.sub_segment_num
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The defualt value is null.SubSegmentsExpected -> (integer)
The number of sub-segments expected, which is assigned to thesegmentation_descriptor.sub_segments_expected
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is null.ClipRange -> (structure)
Clip range configuration for the VOD source associated with the program.
EndOffsetMillis -> (long)
The end offset of the clip range, in milliseconds, starting from the beginning of the VOD source associated with the program.StartOffsetMillis -> (long)
The start offset of the clip range, in milliseconds. This offset truncates the start at the number of milliseconds into the duration of the VOD source.DurationMillis -> (long)
The duration of the alternateMedia in milliseconds.LiveSourceName -> (string)
The name of the live source for alternateMedia.ScheduledStartTimeMillis -> (long)
The date and time that the alternateMedia is scheduled to start, in epoch milliseconds.SourceLocationName -> (string)
The name of the source location for alternateMedia.VodSourceName -> (string)
The name of the VOD source for alternateMedia.Audience -> (string)
The Audience defined in AudienceMedia.
JSON Syntax:
[
{
"AlternateMedia": [
{
"AdBreaks": [
{
"AdBreakMetadata": [
{
"Key": "string",
"Value": "string"
}
...
],
"MessageType": "SPLICE_INSERT"|"TIME_SIGNAL",
"OffsetMillis": long,
"Slate": {
"SourceLocationName": "string",
"VodSourceName": "string"
},
"SpliceInsertMessage": {
"AvailNum": integer,
"AvailsExpected": integer,
"SpliceEventId": integer,
"UniqueProgramId": integer
},
"TimeSignalMessage": {
"SegmentationDescriptors": [
{
"SegmentNum": integer,
"SegmentationEventId": integer,
"SegmentationTypeId": integer,
"SegmentationUpid": "string",
"SegmentationUpidType": integer,
"SegmentsExpected": integer,
"SubSegmentNum": integer,
"SubSegmentsExpected": integer
}
...
]
}
}
...
],
"ClipRange": {
"EndOffsetMillis": long,
"StartOffsetMillis": long
},
"DurationMillis": long,
"LiveSourceName": "string",
"ScheduledStartTimeMillis": long,
"SourceLocationName": "string",
"VodSourceName": "string"
}
...
],
"Audience": "string"
}
...
]
--channel-name
(string)
The name of the channel for this Program.
--live-source-name
(string)
The name of the LiveSource for this Program.
--program-name
(string)
The name of the Program.
--schedule-configuration
(structure)
The schedule configuration settings.
ClipRange -> (structure)
Program clip range configuration.
EndOffsetMillis -> (long)
The end offset of the clip range, in milliseconds, starting from the beginning of the VOD source associated with the program.StartOffsetMillis -> (long)
The start offset of the clip range, in milliseconds. This offset truncates the start at the number of milliseconds into the duration of the VOD source.Transition -> (structure)
Program transition configurations.
DurationMillis -> (long)
The duration of the live program in seconds.RelativePosition -> (string)
The position where this program will be inserted relative to theRelativePosition
.RelativeProgram -> (string)
The name of the program that this program will be inserted next to, as defined byRelativePosition
.ScheduledStartTimeMillis -> (long)
The date and time that the program is scheduled to start, in epoch milliseconds.Type -> (string)
Defines when the program plays in the schedule. You can set the value to
ABSOLUTE
orRELATIVE
.ABSOLUTE
- The program plays at a specific wall clock time. This setting can only be used for channels using theLINEAR
PlaybackMode
.Note the following considerations when using
ABSOLUTE
transitions:If the preceding program in the schedule has a duration that extends past the wall clock time, MediaTailor truncates the preceding program on a common segment boundary.
If there are gaps in playback, MediaTailor plays the
FillerSlate
you configured for your linear channel.RELATIVE
- The program is inserted into the schedule either before or after a program that you specify viaRelativePosition
.
Shorthand Syntax:
ClipRange={EndOffsetMillis=long,StartOffsetMillis=long},Transition={DurationMillis=long,RelativePosition=string,RelativeProgram=string,ScheduledStartTimeMillis=long,Type=string}
JSON Syntax:
{
"ClipRange": {
"EndOffsetMillis": long,
"StartOffsetMillis": long
},
"Transition": {
"DurationMillis": long,
"RelativePosition": "BEFORE_PROGRAM"|"AFTER_PROGRAM",
"RelativeProgram": "string",
"ScheduledStartTimeMillis": long,
"Type": "string"
}
}
--source-location-name
(string)
The name of the source location.
--vod-source-name
(string)
The name that's used to refer to a VOD source.
--cli-input-json
(string)
Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton
. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.
--generate-cli-skeleton
(string)
Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input
, prints a sample input JSON that can be used as an argument for --cli-input-json
. If provided with the value output
, it validates the command inputs and returns a sample output JSON for that command.
--debug
(boolean)
Turn on debug logging.
--endpoint-url
(string)
Override command's default URL with the given URL.
--no-verify-ssl
(boolean)
By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.
--no-paginate
(boolean)
Disable automatic pagination. If automatic pagination is disabled, the AWS CLI will only make one call, for the first page of results.
--output
(string)
The formatting style for command output.
--query
(string)
A JMESPath query to use in filtering the response data.
--profile
(string)
Use a specific profile from your credential file.
--region
(string)
The region to use. Overrides config/env settings.
--version
(string)
Display the version of this tool.
--color
(string)
Turn on/off color output.
--no-sign-request
(boolean)
Do not sign requests. Credentials will not be loaded if this argument is provided.
--ca-bundle
(string)
The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.
--cli-read-timeout
(int)
The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.
--cli-connect-timeout
(int)
The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.
AdBreaks -> (list)
The ad break configuration settings.
(structure)
Ad break configuration parameters.
AdBreakMetadata -> (list)
Defines a list of key/value pairs that MediaTailor generates within the
EXT-X-ASSET
tag forSCTE35_ENHANCED
output.(structure)
For
SCTE35_ENHANCED
output, defines a key and corresponding value. MediaTailor generates these pairs within theEXT-X-ASSET
tag.Key -> (string)
ForSCTE35_ENHANCED
output, defines a key. MediaTailor takes this key, and its associated value, and generates the key/value pair within theEXT-X-ASSET
tag. If you specify a key, you must also specify a corresponding value.Value -> (string)
ForSCTE35_ENHANCED
output, defines a value. MediaTailor; takes this value, and its associated key, and generates the key/value pair within theEXT-X-ASSET
tag. If you specify a value, you must also specify a corresponding key.MessageType -> (string)
The SCTE-35 ad insertion type. Accepted value:SPLICE_INSERT
,TIME_SIGNAL
.OffsetMillis -> (long)
How long (in milliseconds) after the beginning of the program that an ad starts. This value must fall within 100ms of a segment boundary, otherwise the ad break will be skipped.Slate -> (structure)
Ad break slate configuration.
SourceLocationName -> (string)
The name of the source location where the slate VOD source is stored.VodSourceName -> (string)
The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate.SpliceInsertMessage -> (structure)
This defines the SCTE-35
splice_insert()
message inserted around the ad. For information about usingsplice_insert()
, see the SCTE-35 specficiaiton, section 9.7.3.1.AvailNum -> (integer)
This is written tosplice_insert.avail_num
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is0
. Values must be between0
and256
, inclusive.AvailsExpected -> (integer)
This is written tosplice_insert.avails_expected
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is0
. Values must be between0
and256
, inclusive.SpliceEventId -> (integer)
This is written tosplice_insert.splice_event_id
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is1
.UniqueProgramId -> (integer)
This is written tosplice_insert.unique_program_id
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is0
. Values must be between0
and256
, inclusive.TimeSignalMessage -> (structure)
Defines the SCTE-35
time_signal
message inserted around the ad.Programs on a channel's schedule can be configured with one or more ad breaks. You can attach a
splice_insert
SCTE-35 message to the ad break. This message provides basic metadata about the ad break.See section 9.7.4 of the 2022 SCTE-35 specification for more information.
SegmentationDescriptors -> (list)
The configurations for the SCTE-35
segmentation_descriptor
message(s) sent with thetime_signal
message.(structure)
The
segmentation_descriptor
message can contain advanced metadata fields, like content identifiers, to convey a wide range of information about the ad break. MediaTailor writes the ad metadata in the egress manifest as part of theEXT-X-DATERANGE
orEventStream
ad marker's SCTE-35 data.segmentation_descriptor
messages must be sent with thetime_signal
message type.See the
segmentation_descriptor()
table of the 2022 SCTE-35 specification for more information.SegmentNum -> (integer)
The segment number to assign to thesegmentation_descriptor.segment_num
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification Values must be between 0 and 256, inclusive. The default value is 0.SegmentationEventId -> (integer)
The Event Identifier to assign to thesegmentation_descriptor.segmentation_event_id
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. The default value is 1.SegmentationTypeId -> (integer)
The Type Identifier to assign to thesegmentation_descriptor.segmentation_type_id
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is 48.SegmentationUpid -> (string)
The Upid to assign to thesegmentation_descriptor.segmentation_upid
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. The value must be a hexadecimal string containing only the characters 0 though 9 and A through F. The default value is "" (an empty string).SegmentationUpidType -> (integer)
The Upid Type to assign to thesegmentation_descriptor.segmentation_upid_type
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is 14.SegmentsExpected -> (integer)
The number of segments expected, which is assigned to thesegmentation_descriptor.segments_expectedS
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification Values must be between 0 and 256, inclusive. The default value is 0.SubSegmentNum -> (integer)
The sub-segment number to assign to thesegmentation_descriptor.sub_segment_num
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The defualt value is null.SubSegmentsExpected -> (integer)
The number of sub-segments expected, which is assigned to thesegmentation_descriptor.sub_segments_expected
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is null.
Arn -> (string)
The ARN to assign to the program.
AudienceMedia -> (list)
The list of AudienceMedia defined in program.
(structure)
An AudienceMedia object contains an Audience and a list of AlternateMedia.
AlternateMedia -> (list)
The list of AlternateMedia defined in AudienceMedia.
(structure)
A playlist of media (VOD and/or live) to be played instead of the default media on a particular program.
AdBreaks -> (list)
Ad break configuration parameters defined in AlternateMedia.
(structure)
Ad break configuration parameters.
AdBreakMetadata -> (list)
Defines a list of key/value pairs that MediaTailor generates within the
EXT-X-ASSET
tag forSCTE35_ENHANCED
output.(structure)
For
SCTE35_ENHANCED
output, defines a key and corresponding value. MediaTailor generates these pairs within theEXT-X-ASSET
tag.Key -> (string)
ForSCTE35_ENHANCED
output, defines a key. MediaTailor takes this key, and its associated value, and generates the key/value pair within theEXT-X-ASSET
tag. If you specify a key, you must also specify a corresponding value.Value -> (string)
ForSCTE35_ENHANCED
output, defines a value. MediaTailor; takes this value, and its associated key, and generates the key/value pair within theEXT-X-ASSET
tag. If you specify a value, you must also specify a corresponding key.MessageType -> (string)
The SCTE-35 ad insertion type. Accepted value:SPLICE_INSERT
,TIME_SIGNAL
.OffsetMillis -> (long)
How long (in milliseconds) after the beginning of the program that an ad starts. This value must fall within 100ms of a segment boundary, otherwise the ad break will be skipped.Slate -> (structure)
Ad break slate configuration.
SourceLocationName -> (string)
The name of the source location where the slate VOD source is stored.VodSourceName -> (string)
The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate.SpliceInsertMessage -> (structure)
This defines the SCTE-35
splice_insert()
message inserted around the ad. For information about usingsplice_insert()
, see the SCTE-35 specficiaiton, section 9.7.3.1.AvailNum -> (integer)
This is written tosplice_insert.avail_num
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is0
. Values must be between0
and256
, inclusive.AvailsExpected -> (integer)
This is written tosplice_insert.avails_expected
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is0
. Values must be between0
and256
, inclusive.SpliceEventId -> (integer)
This is written tosplice_insert.splice_event_id
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is1
.UniqueProgramId -> (integer)
This is written tosplice_insert.unique_program_id
, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is0
. Values must be between0
and256
, inclusive.TimeSignalMessage -> (structure)
Defines the SCTE-35
time_signal
message inserted around the ad.Programs on a channel's schedule can be configured with one or more ad breaks. You can attach a
splice_insert
SCTE-35 message to the ad break. This message provides basic metadata about the ad break.See section 9.7.4 of the 2022 SCTE-35 specification for more information.
SegmentationDescriptors -> (list)
The configurations for the SCTE-35
segmentation_descriptor
message(s) sent with thetime_signal
message.(structure)
The
segmentation_descriptor
message can contain advanced metadata fields, like content identifiers, to convey a wide range of information about the ad break. MediaTailor writes the ad metadata in the egress manifest as part of theEXT-X-DATERANGE
orEventStream
ad marker's SCTE-35 data.segmentation_descriptor
messages must be sent with thetime_signal
message type.See the
segmentation_descriptor()
table of the 2022 SCTE-35 specification for more information.SegmentNum -> (integer)
The segment number to assign to thesegmentation_descriptor.segment_num
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification Values must be between 0 and 256, inclusive. The default value is 0.SegmentationEventId -> (integer)
The Event Identifier to assign to thesegmentation_descriptor.segmentation_event_id
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. The default value is 1.SegmentationTypeId -> (integer)
The Type Identifier to assign to thesegmentation_descriptor.segmentation_type_id
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is 48.SegmentationUpid -> (string)
The Upid to assign to thesegmentation_descriptor.segmentation_upid
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. The value must be a hexadecimal string containing only the characters 0 though 9 and A through F. The default value is "" (an empty string).SegmentationUpidType -> (integer)
The Upid Type to assign to thesegmentation_descriptor.segmentation_upid_type
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is 14.SegmentsExpected -> (integer)
The number of segments expected, which is assigned to thesegmentation_descriptor.segments_expectedS
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification Values must be between 0 and 256, inclusive. The default value is 0.SubSegmentNum -> (integer)
The sub-segment number to assign to thesegmentation_descriptor.sub_segment_num
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The defualt value is null.SubSegmentsExpected -> (integer)
The number of sub-segments expected, which is assigned to thesegmentation_descriptor.sub_segments_expected
message, as defined in section 10.3.3.1 of the 2022 SCTE-35 specification. Values must be between 0 and 256, inclusive. The default value is null.ClipRange -> (structure)
Clip range configuration for the VOD source associated with the program.
EndOffsetMillis -> (long)
The end offset of the clip range, in milliseconds, starting from the beginning of the VOD source associated with the program.StartOffsetMillis -> (long)
The start offset of the clip range, in milliseconds. This offset truncates the start at the number of milliseconds into the duration of the VOD source.DurationMillis -> (long)
The duration of the alternateMedia in milliseconds.LiveSourceName -> (string)
The name of the live source for alternateMedia.ScheduledStartTimeMillis -> (long)
The date and time that the alternateMedia is scheduled to start, in epoch milliseconds.SourceLocationName -> (string)
The name of the source location for alternateMedia.VodSourceName -> (string)
The name of the VOD source for alternateMedia.Audience -> (string)
The Audience defined in AudienceMedia.
ChannelName -> (string)
The name to assign to the channel for this program.
ClipRange -> (structure)
The clip range configuration settings.
EndOffsetMillis -> (long)
The end offset of the clip range, in milliseconds, starting from the beginning of the VOD source associated with the program.StartOffsetMillis -> (long)
The start offset of the clip range, in milliseconds. This offset truncates the start at the number of milliseconds into the duration of the VOD source.
CreationTime -> (timestamp)
The time the program was created.
DurationMillis -> (long)
The duration of the live program in milliseconds.
LiveSourceName -> (string)
The name of the LiveSource for this Program.
ProgramName -> (string)
The name to assign to this program.
ScheduledStartTime -> (timestamp)
The scheduled start time for this Program.
SourceLocationName -> (string)
The name to assign to the source location for this program.
VodSourceName -> (string)
The name that's used to refer to a VOD source.