This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html). # AWS Elemental MediaTailor **Resource types** + [AWS::MediaTailor::Channel](aws-resource-mediatailor-channel.md) + [AWS::MediaTailor::ChannelPolicy](aws-resource-mediatailor-channelpolicy.md) + [AWS::MediaTailor::LiveSource](aws-resource-mediatailor-livesource.md) + [AWS::MediaTailor::PlaybackConfiguration](aws-resource-mediatailor-playbackconfiguration.md) + [AWS::MediaTailor::SourceLocation](aws-resource-mediatailor-sourcelocation.md) + [AWS::MediaTailor::VodSource](aws-resource-mediatailor-vodsource.md) # AWS::MediaTailor::Channel The configuration parameters for a channel. For information about MediaTailor channels, see [Working with channels](https://docs.aws.amazon.com/mediatailor/latest/ug/channel-assembly-channels.html) in the *MediaTailor User Guide*. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "Type" : "AWS::MediaTailor::Channel", "Properties" : { "[Audiences](#cfn-mediatailor-channel-audiences)" : [ String, ... ], "[ChannelName](#cfn-mediatailor-channel-channelname)" : String, "[FillerSlate](#cfn-mediatailor-channel-fillerslate)" : SlateSource, "[LogConfiguration](#cfn-mediatailor-channel-logconfiguration)" : LogConfigurationForChannel, "[Outputs](#cfn-mediatailor-channel-outputs)" : [ RequestOutputItem, ... ], "[PlaybackMode](#cfn-mediatailor-channel-playbackmode)" : String, "[Tags](#cfn-mediatailor-channel-tags)" : [ Tag, ... ], "[Tier](#cfn-mediatailor-channel-tier)" : String, "[TimeShiftConfiguration](#cfn-mediatailor-channel-timeshiftconfiguration)" : TimeShiftConfiguration } } ``` ### YAML ``` Type: AWS::MediaTailor::Channel Properties: [Audiences](#cfn-mediatailor-channel-audiences): - String [ChannelName](#cfn-mediatailor-channel-channelname): String [FillerSlate](#cfn-mediatailor-channel-fillerslate): SlateSource [LogConfiguration](#cfn-mediatailor-channel-logconfiguration): LogConfigurationForChannel [Outputs](#cfn-mediatailor-channel-outputs): - RequestOutputItem [PlaybackMode](#cfn-mediatailor-channel-playbackmode): String [Tags](#cfn-mediatailor-channel-tags): - Tag [Tier](#cfn-mediatailor-channel-tier): String [TimeShiftConfiguration](#cfn-mediatailor-channel-timeshiftconfiguration): TimeShiftConfiguration ``` ## Properties `Audiences` The list of audiences defined in channel. *Required*: No *Type*: Array of String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `ChannelName` The name of the channel. *Required*: Yes *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `FillerSlate` The slate used to fill gaps between programs in the schedule. You must configure filler slate if your channel uses the `LINEAR``PlaybackMode`. MediaTailor doesn't support filler slate for channels using the `LOOP``PlaybackMode`. *Required*: No *Type*: [SlateSource](aws-properties-mediatailor-channel-slatesource.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `LogConfiguration` The log configuration. *Required*: No *Type*: [LogConfigurationForChannel](aws-properties-mediatailor-channel-logconfigurationforchannel.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Outputs` The channel's output properties. *Required*: Yes *Type*: Array of [RequestOutputItem](aws-properties-mediatailor-channel-requestoutputitem.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `PlaybackMode` The type of playback mode for this channel. `LINEAR` - Programs play back-to-back only once. `LOOP` - Programs play back-to-back in an endless loop. When the last program in the schedule plays, playback loops back to the first program in the schedule. *Required*: Yes *Type*: String *Allowed values*: `LOOP | LINEAR` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Tags` The tags to assign to the channel. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see [Tagging AWS Elemental MediaTailor Resources](https://docs.aws.amazon.com/mediatailor/latest/ug/tagging.html). *Required*: No *Type*: Array of [Tag](aws-properties-mediatailor-channel-tag.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Tier` The tier for this channel. STANDARD tier channels can contain live programs. *Required*: No *Type*: String *Allowed values*: `BASIC | STANDARD` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `TimeShiftConfiguration` The configuration for time-shifted viewing. *Required*: No *Type*: [TimeShiftConfiguration](aws-properties-mediatailor-channel-timeshiftconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) ## Return values ### Ref ### Fn::GetAtt #### `Arn` Property description not available. # AWS::MediaTailor::Channel DashPlaylistSettings Dash manifest configuration parameters. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[ManifestWindowSeconds](#cfn-mediatailor-channel-dashplaylistsettings-manifestwindowseconds)" : Number, "[MinBufferTimeSeconds](#cfn-mediatailor-channel-dashplaylistsettings-minbuffertimeseconds)" : Number, "[MinUpdatePeriodSeconds](#cfn-mediatailor-channel-dashplaylistsettings-minupdateperiodseconds)" : Number, "[SuggestedPresentationDelaySeconds](#cfn-mediatailor-channel-dashplaylistsettings-suggestedpresentationdelayseconds)" : Number } ``` ### YAML ``` [ManifestWindowSeconds](#cfn-mediatailor-channel-dashplaylistsettings-manifestwindowseconds): Number [MinBufferTimeSeconds](#cfn-mediatailor-channel-dashplaylistsettings-minbuffertimeseconds): Number [MinUpdatePeriodSeconds](#cfn-mediatailor-channel-dashplaylistsettings-minupdateperiodseconds): Number [SuggestedPresentationDelaySeconds](#cfn-mediatailor-channel-dashplaylistsettings-suggestedpresentationdelayseconds): Number ``` ## Properties `ManifestWindowSeconds` The total duration (in seconds) of each manifest. Minimum value: `30` seconds. Maximum value: `3600` seconds. *Required*: No *Type*: Number *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `MinBufferTimeSeconds` Minimum amount of content (measured in seconds) that a player must keep available in the buffer. Minimum value: `2` seconds. Maximum value: `60` seconds. *Required*: No *Type*: Number *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `MinUpdatePeriodSeconds` Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest. Minimum value: `2` seconds. Maximum value: `60` seconds. *Required*: No *Type*: Number *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `SuggestedPresentationDelaySeconds` Amount of time (in seconds) that the player should be from the live point at the end of the manifest. Minimum value: `2` seconds. Maximum value: `60` seconds. *Required*: No *Type*: Number *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::Channel HlsPlaylistSettings HLS playlist configuration parameters. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[AdMarkupType](#cfn-mediatailor-channel-hlsplaylistsettings-admarkuptype)" : [ String, ... ], "[ManifestWindowSeconds](#cfn-mediatailor-channel-hlsplaylistsettings-manifestwindowseconds)" : Number } ``` ### YAML ``` [AdMarkupType](#cfn-mediatailor-channel-hlsplaylistsettings-admarkuptype): - String [ManifestWindowSeconds](#cfn-mediatailor-channel-hlsplaylistsettings-manifestwindowseconds): Number ``` ## Properties `AdMarkupType` Determines the type of SCTE 35 tags to use in ad markup. Specify `DATERANGE` to use `DATERANGE` tags (for live or VOD content). Specify `SCTE35_ENHANCED` to use `EXT-X-CUE-OUT` and `EXT-X-CUE-IN` tags (for VOD content only). *Required*: No *Type*: Array of String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `ManifestWindowSeconds` The total duration (in seconds) of each manifest. Minimum value: `30` seconds. Maximum value: `3600` seconds. *Required*: No *Type*: Number *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::Channel LogConfigurationForChannel The log configuration for the channel. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[LogTypes](#cfn-mediatailor-channel-logconfigurationforchannel-logtypes)" : [ String, ... ] } ``` ### YAML ``` [LogTypes](#cfn-mediatailor-channel-logconfigurationforchannel-logtypes): - String ``` ## Properties `LogTypes` The log types. *Required*: No *Type*: Array of String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::Channel RequestOutputItem The output configuration for this channel. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[DashPlaylistSettings](#cfn-mediatailor-channel-requestoutputitem-dashplaylistsettings)" : DashPlaylistSettings, "[HlsPlaylistSettings](#cfn-mediatailor-channel-requestoutputitem-hlsplaylistsettings)" : HlsPlaylistSettings, "[ManifestName](#cfn-mediatailor-channel-requestoutputitem-manifestname)" : String, "[SourceGroup](#cfn-mediatailor-channel-requestoutputitem-sourcegroup)" : String } ``` ### YAML ``` [DashPlaylistSettings](#cfn-mediatailor-channel-requestoutputitem-dashplaylistsettings): DashPlaylistSettings [HlsPlaylistSettings](#cfn-mediatailor-channel-requestoutputitem-hlsplaylistsettings): HlsPlaylistSettings [ManifestName](#cfn-mediatailor-channel-requestoutputitem-manifestname): String [SourceGroup](#cfn-mediatailor-channel-requestoutputitem-sourcegroup): String ``` ## Properties `DashPlaylistSettings` DASH manifest configuration parameters. *Required*: No *Type*: [DashPlaylistSettings](aws-properties-mediatailor-channel-dashplaylistsettings.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `HlsPlaylistSettings` HLS playlist configuration parameters. *Required*: No *Type*: [HlsPlaylistSettings](aws-properties-mediatailor-channel-hlsplaylistsettings.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `ManifestName` The name of the manifest for the channel. The name appears in the `PlaybackUrl`. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `SourceGroup` A string used to match which `HttpPackageConfiguration` is used for each `VodSource`. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::Channel SlateSource Slate VOD source configuration. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[SourceLocationName](#cfn-mediatailor-channel-slatesource-sourcelocationname)" : String, "[VodSourceName](#cfn-mediatailor-channel-slatesource-vodsourcename)" : String } ``` ### YAML ``` [SourceLocationName](#cfn-mediatailor-channel-slatesource-sourcelocationname): String [VodSourceName](#cfn-mediatailor-channel-slatesource-vodsourcename): String ``` ## Properties `SourceLocationName` The name of the source location where the slate VOD source is stored. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `VodSourceName` The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::Channel Tag The `Tag` property type specifies Property description not available. for an [AWS::MediaTailor::Channel](aws-resource-mediatailor-channel.md). ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Key](#cfn-mediatailor-channel-tag-key)" : String, "[Value](#cfn-mediatailor-channel-tag-value)" : String } ``` ### YAML ``` [Key](#cfn-mediatailor-channel-tag-key): String [Value](#cfn-mediatailor-channel-tag-value): String ``` ## Properties `Key` Property description not available. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Value` Property description not available. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::Channel TimeShiftConfiguration The configuration for time-shifted viewing. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[MaxTimeDelaySeconds](#cfn-mediatailor-channel-timeshiftconfiguration-maxtimedelayseconds)" : Number } ``` ### YAML ``` [MaxTimeDelaySeconds](#cfn-mediatailor-channel-timeshiftconfiguration-maxtimedelayseconds): Number ``` ## Properties `MaxTimeDelaySeconds` The maximum time delay for time-shifted viewing. The minimum allowed maximum time delay is 0 seconds, and the maximum allowed maximum time delay is 21600 seconds (6 hours). *Required*: Yes *Type*: Number *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::ChannelPolicy Specifies an IAM policy for the channel. IAM policies are used to control access to your channel. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "Type" : "AWS::MediaTailor::ChannelPolicy", "Properties" : { "[ChannelName](#cfn-mediatailor-channelpolicy-channelname)" : String, "[Policy](#cfn-mediatailor-channelpolicy-policy)" : Json } } ``` ### YAML ``` Type: AWS::MediaTailor::ChannelPolicy Properties: [ChannelName](#cfn-mediatailor-channelpolicy-channelname): String [Policy](#cfn-mediatailor-channelpolicy-policy): Json ``` ## Properties `ChannelName` The name of the channel associated with this Channel Policy. *Required*: Yes *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Policy` The IAM policy for the channel. IAM policies are used to control access to your channel. *Required*: Yes *Type*: Json *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) ## Return values ### Ref # AWS::MediaTailor::LiveSource Live source configuration parameters. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "Type" : "AWS::MediaTailor::LiveSource", "Properties" : { "[HttpPackageConfigurations](#cfn-mediatailor-livesource-httppackageconfigurations)" : [ HttpPackageConfiguration, ... ], "[LiveSourceName](#cfn-mediatailor-livesource-livesourcename)" : String, "[SourceLocationName](#cfn-mediatailor-livesource-sourcelocationname)" : String, "[Tags](#cfn-mediatailor-livesource-tags)" : [ Tag, ... ] } } ``` ### YAML ``` Type: AWS::MediaTailor::LiveSource Properties: [HttpPackageConfigurations](#cfn-mediatailor-livesource-httppackageconfigurations): - HttpPackageConfiguration [LiveSourceName](#cfn-mediatailor-livesource-livesourcename): String [SourceLocationName](#cfn-mediatailor-livesource-sourcelocationname): String [Tags](#cfn-mediatailor-livesource-tags): - Tag ``` ## Properties `HttpPackageConfigurations` The HTTP package configurations for the live source. *Required*: Yes *Type*: Array of [HttpPackageConfiguration](aws-properties-mediatailor-livesource-httppackageconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `LiveSourceName` The name that's used to refer to a live source. *Required*: Yes *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `SourceLocationName` The name of the source location. *Required*: Yes *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Tags` The tags assigned to the live source. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see [Tagging AWS Elemental MediaTailor Resources](https://docs.aws.amazon.com/mediatailor/latest/ug/tagging.html). *Required*: No *Type*: Array of [Tag](aws-properties-mediatailor-livesource-tag.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) ## Return values ### Ref ### Fn::GetAtt #### `Arn` Property description not available. # AWS::MediaTailor::LiveSource HttpPackageConfiguration The HTTP package configuration properties for the requested VOD source. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Path](#cfn-mediatailor-livesource-httppackageconfiguration-path)" : String, "[SourceGroup](#cfn-mediatailor-livesource-httppackageconfiguration-sourcegroup)" : String, "[Type](#cfn-mediatailor-livesource-httppackageconfiguration-type)" : String } ``` ### YAML ``` [Path](#cfn-mediatailor-livesource-httppackageconfiguration-path): String [SourceGroup](#cfn-mediatailor-livesource-httppackageconfiguration-sourcegroup): String [Type](#cfn-mediatailor-livesource-httppackageconfiguration-type): String ``` ## Properties `Path` The relative path to the URL for this VOD source. This is combined with `SourceLocation::HttpConfiguration::BaseUrl` to form a valid URL. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `SourceGroup` The name of the source group. This has to match one of the `Channel::Outputs::SourceGroup`. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Type` The streaming protocol for this package configuration. Supported values are `HLS` and `DASH`. *Required*: Yes *Type*: String *Allowed values*: `DASH | HLS` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::LiveSource Tag One tag that you want to add to the specified resource. A tag consists of a `Key` (a name for the tag) and a Value. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Key](#cfn-mediatailor-livesource-tag-key)" : String, "[Value](#cfn-mediatailor-livesource-tag-value)" : String } ``` ### YAML ``` [Key](#cfn-mediatailor-livesource-tag-key): String [Value](#cfn-mediatailor-livesource-tag-value): String ``` ## Properties `Key` Property description not available. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Value` Property description not available. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration Adds a new playback configuration to AWS Elemental MediaTailor. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "Type" : "AWS::MediaTailor::PlaybackConfiguration", "Properties" : { "[AdConditioningConfiguration](#cfn-mediatailor-playbackconfiguration-adconditioningconfiguration)" : AdConditioningConfiguration, "[AdDecisionServerConfiguration](#cfn-mediatailor-playbackconfiguration-addecisionserverconfiguration)" : AdDecisionServerConfiguration, "[AdDecisionServerUrl](#cfn-mediatailor-playbackconfiguration-addecisionserverurl)" : String, "[AvailSuppression](#cfn-mediatailor-playbackconfiguration-availsuppression)" : AvailSuppression, "[Bumper](#cfn-mediatailor-playbackconfiguration-bumper)" : Bumper, "[CdnConfiguration](#cfn-mediatailor-playbackconfiguration-cdnconfiguration)" : CdnConfiguration, "[ConfigurationAliases](#cfn-mediatailor-playbackconfiguration-configurationaliases)" : {Key: Value, ...}, "[DashConfiguration](#cfn-mediatailor-playbackconfiguration-dashconfiguration)" : DashConfiguration, "[HlsConfiguration](#cfn-mediatailor-playbackconfiguration-hlsconfiguration)" : HlsConfiguration, "[InsertionMode](#cfn-mediatailor-playbackconfiguration-insertionmode)" : String, "[LivePreRollConfiguration](#cfn-mediatailor-playbackconfiguration-liveprerollconfiguration)" : LivePreRollConfiguration, "[LogConfiguration](#cfn-mediatailor-playbackconfiguration-logconfiguration)" : LogConfiguration, "[ManifestProcessingRules](#cfn-mediatailor-playbackconfiguration-manifestprocessingrules)" : ManifestProcessingRules, "[Name](#cfn-mediatailor-playbackconfiguration-name)" : String, "[PersonalizationThresholdSeconds](#cfn-mediatailor-playbackconfiguration-personalizationthresholdseconds)" : Integer, "[SlateAdUrl](#cfn-mediatailor-playbackconfiguration-slateadurl)" : String, "[Tags](#cfn-mediatailor-playbackconfiguration-tags)" : [ Tag, ... ], "[TranscodeProfileName](#cfn-mediatailor-playbackconfiguration-transcodeprofilename)" : String, "[VideoContentSourceUrl](#cfn-mediatailor-playbackconfiguration-videocontentsourceurl)" : String } } ``` ### YAML ``` Type: AWS::MediaTailor::PlaybackConfiguration Properties: [AdConditioningConfiguration](#cfn-mediatailor-playbackconfiguration-adconditioningconfiguration): AdConditioningConfiguration [AdDecisionServerConfiguration](#cfn-mediatailor-playbackconfiguration-addecisionserverconfiguration): AdDecisionServerConfiguration [AdDecisionServerUrl](#cfn-mediatailor-playbackconfiguration-addecisionserverurl): String [AvailSuppression](#cfn-mediatailor-playbackconfiguration-availsuppression): AvailSuppression [Bumper](#cfn-mediatailor-playbackconfiguration-bumper): Bumper [CdnConfiguration](#cfn-mediatailor-playbackconfiguration-cdnconfiguration): CdnConfiguration [ConfigurationAliases](#cfn-mediatailor-playbackconfiguration-configurationaliases): Key: Value [DashConfiguration](#cfn-mediatailor-playbackconfiguration-dashconfiguration): DashConfiguration [HlsConfiguration](#cfn-mediatailor-playbackconfiguration-hlsconfiguration): HlsConfiguration [InsertionMode](#cfn-mediatailor-playbackconfiguration-insertionmode): String [LivePreRollConfiguration](#cfn-mediatailor-playbackconfiguration-liveprerollconfiguration): LivePreRollConfiguration [LogConfiguration](#cfn-mediatailor-playbackconfiguration-logconfiguration): LogConfiguration [ManifestProcessingRules](#cfn-mediatailor-playbackconfiguration-manifestprocessingrules): ManifestProcessingRules [Name](#cfn-mediatailor-playbackconfiguration-name): String [PersonalizationThresholdSeconds](#cfn-mediatailor-playbackconfiguration-personalizationthresholdseconds): Integer [SlateAdUrl](#cfn-mediatailor-playbackconfiguration-slateadurl): String [Tags](#cfn-mediatailor-playbackconfiguration-tags): - Tag [TranscodeProfileName](#cfn-mediatailor-playbackconfiguration-transcodeprofilename): String [VideoContentSourceUrl](#cfn-mediatailor-playbackconfiguration-videocontentsourceurl): String ``` ## Properties `AdConditioningConfiguration` The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns, and what priority MediaTailor uses when inserting ads. *Required*: No *Type*: [AdConditioningConfiguration](aws-properties-mediatailor-playbackconfiguration-adconditioningconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `AdDecisionServerConfiguration` Property description not available. *Required*: No *Type*: [AdDecisionServerConfiguration](aws-properties-mediatailor-playbackconfiguration-addecisionserverconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `AdDecisionServerUrl` The URL for the ad decision server (ADS). This includes the specification of static parameters and placeholders for dynamic parameters. AWS Elemental MediaTailor substitutes player-specific and session-specific parameters as needed when calling the ADS. Alternately, for testing you can provide a static VAST URL. The maximum length is 25,000 characters. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `AvailSuppression` The configuration for avail suppression, also known as ad suppression. For more information about ad suppression, see [Ad Suppression](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-behavior.html). *Required*: No *Type*: [AvailSuppression](aws-properties-mediatailor-playbackconfiguration-availsuppression.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Bumper` The configuration for bumpers. Bumpers are short audio or video clips that play at the start or before the end of an ad break. To learn more about bumpers, see [Bumpers](https://docs.aws.amazon.com/mediatailor/latest/ug/bumpers.html). *Required*: No *Type*: [Bumper](aws-properties-mediatailor-playbackconfiguration-bumper.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `CdnConfiguration` The configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management. *Required*: No *Type*: [CdnConfiguration](aws-properties-mediatailor-playbackconfiguration-cdnconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `ConfigurationAliases` The player parameters and aliases used as dynamic variables during session initialization. For more information, see [Domain Variables](https://docs.aws.amazon.com/mediatailor/latest/ug/variables-domain.html). *Required*: No *Type*: Object *Pattern*: `player_params\.\w+\Z` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `DashConfiguration` The configuration for a DASH source. *Required*: No *Type*: [DashConfiguration](aws-properties-mediatailor-playbackconfiguration-dashconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `HlsConfiguration` The configuration for HLS content. *Required*: No *Type*: [HlsConfiguration](aws-properties-mediatailor-playbackconfiguration-hlsconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `InsertionMode` The setting that controls whether players can use stitched or guided ad insertion. The default, `STITCHED_ONLY`, forces all player sessions to use stitched (server-side) ad insertion. Choosing `PLAYER_SELECT` allows players to select either stitched or guided ad insertion at session-initialization time. The default for players that do not specify an insertion mode is stitched. *Required*: No *Type*: String *Allowed values*: `STITCHED_ONLY | PLAYER_SELECT` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `LivePreRollConfiguration` The configuration for pre-roll ad insertion. *Required*: No *Type*: [LivePreRollConfiguration](aws-properties-mediatailor-playbackconfiguration-liveprerollconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `LogConfiguration` Defines where AWS Elemental MediaTailor sends logs for the playback configuration. *Required*: No *Type*: [LogConfiguration](aws-properties-mediatailor-playbackconfiguration-logconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `ManifestProcessingRules` The configuration for manifest processing rules. Manifest processing rules enable customization of the personalized manifests created by MediaTailor. *Required*: No *Type*: [ManifestProcessingRules](aws-properties-mediatailor-playbackconfiguration-manifestprocessingrules.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Name` The identifier for the playback configuration. *Required*: Yes *Type*: String *Pattern*: `^[a-zA-Z0-9_-]+$` *Minimum*: `1` *Maximum*: `64` *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `PersonalizationThresholdSeconds` Defines the maximum duration of underfilled ad time (in seconds) allowed in an ad break. If the duration of underfilled ad time exceeds the personalization threshold, then the personalization of the ad break is abandoned and the underlying content is shown. This feature applies to *ad replacement* in live and VOD streams, rather than ad insertion, because it relies on an underlying content stream. For more information about ad break behavior, including ad replacement and insertion, see [Ad Behavior in AWS Elemental MediaTailor](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-behavior.html). *Required*: No *Type*: Integer *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `SlateAdUrl` The URL for a video asset to transcode and use to fill in time that's not used by ads. AWS Elemental MediaTailor shows the slate to fill in gaps in media content. Configuring the slate is optional for non-VPAID playback configurations. For VPAID, the slate is required because MediaTailor provides it in the slots designated for dynamic ad content. The slate must be a high-quality asset that contains both audio and video. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Tags` The tags to assign to the playback configuration. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see [Tagging AWS Elemental MediaTailor Resources](https://docs.aws.amazon.com/mediatailor/latest/ug/tagging.html). *Required*: No *Type*: Array of [Tag](aws-properties-mediatailor-playbackconfiguration-tag.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `TranscodeProfileName` The name that is used to associate this playback configuration with a custom transcode profile. This overrides the dynamic transcoding defaults of MediaTailor. Use this only if you have already set up custom profiles with the help of AWS Support. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `VideoContentSourceUrl` The URL prefix for the parent manifest for the stream, minus the asset ID. The maximum length is 512 characters. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) ## Return values ### Fn::GetAtt The `Fn::GetAtt` intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values. For more information about using the `Fn::GetAtt` intrinsic function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html). #### `DashConfiguration.ManifestEndpointPrefix` The URL generated by MediaTailor to initiate a playback session. The session uses server-side reporting. This setting is ignored in PUT operations. `HlsConfiguration.ManifestEndpointPrefix` The URL that is used to initiate a playback session for devices that support Apple HLS. The session uses server-side reporting. `PlaybackConfigurationArn` The Amazon Resource Name (ARN) for the playback configuration. `PlaybackEndpointPrefix` The URL that the player accesses to get a manifest from MediaTailor. This session will use server-side reporting. `SessionInitializationEndpointPrefix` The URL that the player uses to initialize a session that uses client-side reporting. # AWS::MediaTailor::PlaybackConfiguration AdConditioningConfiguration The setting that indicates what conditioning MediaTailor will perform on ads that the ad decision server (ADS) returns. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[StreamingMediaFileConditioning](#cfn-mediatailor-playbackconfiguration-adconditioningconfiguration-streamingmediafileconditioning)" : String } ``` ### YAML ``` [StreamingMediaFileConditioning](#cfn-mediatailor-playbackconfiguration-adconditioningconfiguration-streamingmediafileconditioning): String ``` ## Properties `StreamingMediaFileConditioning` For ads that have media files with streaming delivery and supported file extensions, indicates what transcoding action MediaTailor takes when it first receives these ads from the ADS. `TRANSCODE` indicates that MediaTailor must transcode the ads. `NONE` indicates that you have already transcoded the ads outside of MediaTailor and don't need them transcoded as part of the ad insertion workflow. For more information about ad conditioning see [Using preconditioned ads](https://docs.aws.amazon.com/mediatailor/latest/ug/precondition-ads.html) in the AWS Elemental MediaTailor user guide. *Required*: Yes *Type*: String *Allowed values*: `TRANSCODE | NONE` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration AdDecisionServerConfiguration The `AdDecisionServerConfiguration` property type specifies Property description not available. for an [AWS::MediaTailor::PlaybackConfiguration](aws-resource-mediatailor-playbackconfiguration.md). ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[HttpRequest](#cfn-mediatailor-playbackconfiguration-addecisionserverconfiguration-httprequest)" : HttpRequest } ``` ### YAML ``` [HttpRequest](#cfn-mediatailor-playbackconfiguration-addecisionserverconfiguration-httprequest): HttpRequest ``` ## Properties `HttpRequest` Property description not available. *Required*: Yes *Type*: [HttpRequest](aws-properties-mediatailor-playbackconfiguration-httprequest.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration AdMarkerPassthrough For HLS, when set to `true`, MediaTailor passes through `EXT-X-CUE-IN`, `EXT-X-CUE-OUT`, and `EXT-X-SPLICEPOINT-SCTE35` ad markers from the origin manifest to the MediaTailor personalized manifest. No logic is applied to these ad markers. For example, if `EXT-X-CUE-OUT` has a value of `60`, but no ads are filled for that ad break, MediaTailor will not set the value to `0`. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Enabled](#cfn-mediatailor-playbackconfiguration-admarkerpassthrough-enabled)" : Boolean } ``` ### YAML ``` [Enabled](#cfn-mediatailor-playbackconfiguration-admarkerpassthrough-enabled): Boolean ``` ## Properties `Enabled` Enables ad marker passthrough for your configuration. *Required*: No *Type*: Boolean *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration AdsInteractionLog Settings for customizing what events are included in logs for interactions with the ad decision server (ADS). For more information about ADS logs, inlcuding descriptions of the event types, see [MediaTailor ADS logs description and event types](https://docs.aws.amazon.com/mediatailor/latest/ug/ads-log-format.html) in AWS Elemental MediaTailor User Guide. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[ExcludeEventTypes](#cfn-mediatailor-playbackconfiguration-adsinteractionlog-excludeeventtypes)" : [ String, ... ], "[PublishOptInEventTypes](#cfn-mediatailor-playbackconfiguration-adsinteractionlog-publishoptineventtypes)" : [ String, ... ] } ``` ### YAML ``` [ExcludeEventTypes](#cfn-mediatailor-playbackconfiguration-adsinteractionlog-excludeeventtypes): - String [PublishOptInEventTypes](#cfn-mediatailor-playbackconfiguration-adsinteractionlog-publishoptineventtypes): - String ``` ## Properties `ExcludeEventTypes` Indicates that MediaTailor won't emit the selected events in the logs for playback sessions that are initialized with this configuration. *Required*: No *Type*: Array of String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `PublishOptInEventTypes` Indicates that MediaTailor emits `RAW_ADS_RESPONSE` logs for playback sessions that are initialized with this configuration. *Required*: No *Type*: Array of String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration AvailSuppression The configuration for avail suppression, also known as ad suppression. For more information about ad suppression, see [Ad Suppression](https://docs.aws.amazon.com/mediatailor/latest/ug/ad-behavior.html). ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[FillPolicy](#cfn-mediatailor-playbackconfiguration-availsuppression-fillpolicy)" : String, "[Mode](#cfn-mediatailor-playbackconfiguration-availsuppression-mode)" : String, "[Value](#cfn-mediatailor-playbackconfiguration-availsuppression-value)" : String } ``` ### YAML ``` [FillPolicy](#cfn-mediatailor-playbackconfiguration-availsuppression-fillpolicy): String [Mode](#cfn-mediatailor-playbackconfiguration-availsuppression-mode): String [Value](#cfn-mediatailor-playbackconfiguration-availsuppression-value): String ``` ## Properties `FillPolicy` Defines the policy to apply to the avail suppression mode. `BEHIND_LIVE_EDGE` will always use the full avail suppression policy. `AFTER_LIVE_EDGE` mode can be used to invoke partial ad break fills when a session starts mid-break. *Required*: No *Type*: String *Allowed values*: `PARTIAL_AVAIL | FULL_AVAIL_ONLY` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Mode` Sets the ad suppression mode. By default, ad suppression is off and all ad breaks are filled with ads or slate. When Mode is set to `BEHIND_LIVE_EDGE`, ad suppression is active and MediaTailor won't fill ad breaks on or behind the ad suppression Value time in the manifest lookback window. When Mode is set to `AFTER_LIVE_EDGE`, ad suppression is active and MediaTailor won't fill ad breaks that are within the live edge plus the avail suppression value. *Required*: No *Type*: String *Allowed values*: `OFF | BEHIND_LIVE_EDGE | AFTER_LIVE_EDGE` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Value` A live edge offset time in HH:MM:SS. MediaTailor won't fill ad breaks on or behind this time in the manifest lookback window. If Value is set to 00:00:00, it is in sync with the live edge, and MediaTailor won't fill any ad breaks on or behind the live edge. If you set a Value time, MediaTailor won't fill any ad breaks on or behind this time in the manifest lookback window. For example, if you set 00:45:00, then MediaTailor will fill ad breaks that occur within 45 minutes behind the live edge, but won't fill ad breaks on or behind 45 minutes behind the live edge. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration Bumper The configuration for bumpers. Bumpers are short audio or video clips that play at the start or before the end of an ad break. To learn more about bumpers, see [Bumpers](https://docs.aws.amazon.com/mediatailor/latest/ug/bumpers.html). ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[EndUrl](#cfn-mediatailor-playbackconfiguration-bumper-endurl)" : String, "[StartUrl](#cfn-mediatailor-playbackconfiguration-bumper-starturl)" : String } ``` ### YAML ``` [EndUrl](#cfn-mediatailor-playbackconfiguration-bumper-endurl): String [StartUrl](#cfn-mediatailor-playbackconfiguration-bumper-starturl): String ``` ## Properties `EndUrl` The URL for the end bumper asset. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `StartUrl` The URL for the start bumper asset. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration CdnConfiguration The configuration for using a content delivery network (CDN), like Amazon CloudFront, for content and ad segment management. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[AdSegmentUrlPrefix](#cfn-mediatailor-playbackconfiguration-cdnconfiguration-adsegmenturlprefix)" : String, "[ContentSegmentUrlPrefix](#cfn-mediatailor-playbackconfiguration-cdnconfiguration-contentsegmenturlprefix)" : String } ``` ### YAML ``` [AdSegmentUrlPrefix](#cfn-mediatailor-playbackconfiguration-cdnconfiguration-adsegmenturlprefix): String [ContentSegmentUrlPrefix](#cfn-mediatailor-playbackconfiguration-cdnconfiguration-contentsegmenturlprefix): String ``` ## Properties `AdSegmentUrlPrefix` A non-default content delivery network (CDN) to serve ad segments. By default, AWS Elemental MediaTailor uses Amazon CloudFront with default cache settings as its CDN for ad segments. To set up an alternate CDN, create a rule in your CDN for the origin ads.mediatailor.**.amazonaws.com. Then specify the rule's name in this `AdSegmentUrlPrefix`. When AWS Elemental MediaTailor serves a manifest, it reports your CDN as the source for ad segments. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `ContentSegmentUrlPrefix` A content delivery network (CDN) to cache content segments, so that content requests don’t always have to go to the origin server. First, create a rule in your CDN for the content segment origin server. Then specify the rule's name in this `ContentSegmentUrlPrefix`. When AWS Elemental MediaTailor serves a manifest, it reports your CDN as the source for content segments. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration DashConfiguration The configuration for DASH content. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[ManifestEndpointPrefix](#cfn-mediatailor-playbackconfiguration-dashconfiguration-manifestendpointprefix)" : String, "[MpdLocation](#cfn-mediatailor-playbackconfiguration-dashconfiguration-mpdlocation)" : String, "[OriginManifestType](#cfn-mediatailor-playbackconfiguration-dashconfiguration-originmanifesttype)" : String } ``` ### YAML ``` [ManifestEndpointPrefix](#cfn-mediatailor-playbackconfiguration-dashconfiguration-manifestendpointprefix): String [MpdLocation](#cfn-mediatailor-playbackconfiguration-dashconfiguration-mpdlocation): String [OriginManifestType](#cfn-mediatailor-playbackconfiguration-dashconfiguration-originmanifesttype): String ``` ## Properties `ManifestEndpointPrefix` The URL generated by MediaTailor to initiate a playback session. The session uses server-side reporting. This setting is ignored in PUT operations. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `MpdLocation` The setting that controls whether MediaTailor includes the Location tag in DASH manifests. MediaTailor populates the Location tag with the URL for manifest update requests, to be used by players that don't support sticky redirects. Disable this if you have CDN routing rules set up for accessing MediaTailor manifests, and you are either using client-side reporting or your players support sticky HTTP redirects. Valid values are `DISABLED` and `EMT_DEFAULT`. The `EMT_DEFAULT` setting enables the inclusion of the tag and is the default value. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `OriginManifestType` The setting that controls whether MediaTailor handles manifests from the origin server as multi-period manifests or single-period manifests. If your origin server produces single-period manifests, set this to `SINGLE_PERIOD`. The default setting is `MULTI_PERIOD`. For multi-period manifests, omit this setting or set it to `MULTI_PERIOD`. *Required*: No *Type*: String *Allowed values*: `SINGLE_PERIOD | MULTI_PERIOD` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration HlsConfiguration The configuration for HLS content. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[ManifestEndpointPrefix](#cfn-mediatailor-playbackconfiguration-hlsconfiguration-manifestendpointprefix)" : String } ``` ### YAML ``` [ManifestEndpointPrefix](#cfn-mediatailor-playbackconfiguration-hlsconfiguration-manifestendpointprefix): String ``` ## Properties `ManifestEndpointPrefix` The URL that is used to initiate a playback session for devices that support Apple HLS. The session uses server-side reporting. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration HttpRequest The `HttpRequest` property type specifies Property description not available. for an [AWS::MediaTailor::PlaybackConfiguration](aws-resource-mediatailor-playbackconfiguration.md). ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Body](#cfn-mediatailor-playbackconfiguration-httprequest-body)" : String, "[CompressRequest](#cfn-mediatailor-playbackconfiguration-httprequest-compressrequest)" : String, "[Headers](#cfn-mediatailor-playbackconfiguration-httprequest-headers)" : {Key: Value, ...}, "[HttpMethod](#cfn-mediatailor-playbackconfiguration-httprequest-httpmethod)" : String } ``` ### YAML ``` [Body](#cfn-mediatailor-playbackconfiguration-httprequest-body): String [CompressRequest](#cfn-mediatailor-playbackconfiguration-httprequest-compressrequest): String [Headers](#cfn-mediatailor-playbackconfiguration-httprequest-headers): Key: Value [HttpMethod](#cfn-mediatailor-playbackconfiguration-httprequest-httpmethod): String ``` ## Properties `Body` Property description not available. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `CompressRequest` Property description not available. *Required*: No *Type*: String *Allowed values*: `NONE | GZIP` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Headers` Property description not available. *Required*: No *Type*: Object of String *Pattern*: `.*` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `HttpMethod` Property description not available. *Required*: No *Type*: String *Allowed values*: `GET | POST` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration LivePreRollConfiguration The configuration for pre-roll ad insertion. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[AdDecisionServerUrl](#cfn-mediatailor-playbackconfiguration-liveprerollconfiguration-addecisionserverurl)" : String, "[MaxDurationSeconds](#cfn-mediatailor-playbackconfiguration-liveprerollconfiguration-maxdurationseconds)" : Integer } ``` ### YAML ``` [AdDecisionServerUrl](#cfn-mediatailor-playbackconfiguration-liveprerollconfiguration-addecisionserverurl): String [MaxDurationSeconds](#cfn-mediatailor-playbackconfiguration-liveprerollconfiguration-maxdurationseconds): Integer ``` ## Properties `AdDecisionServerUrl` The URL for the ad decision server (ADS) for pre-roll ads. This includes the specification of static parameters and placeholders for dynamic parameters. AWS Elemental MediaTailor substitutes player-specific and session-specific parameters as needed when calling the ADS. Alternately, for testing, you can provide a static VAST URL. The maximum length is 25,000 characters. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `MaxDurationSeconds` The maximum allowed duration for the pre-roll ad avail. AWS Elemental MediaTailor won't play pre-roll ads to exceed this duration, regardless of the total duration of ads that the ADS returns. *Required*: No *Type*: Integer *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration LogConfiguration Defines where AWS Elemental MediaTailor sends logs for the playback configuration. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[AdsInteractionLog](#cfn-mediatailor-playbackconfiguration-logconfiguration-adsinteractionlog)" : AdsInteractionLog, "[EnabledLoggingStrategies](#cfn-mediatailor-playbackconfiguration-logconfiguration-enabledloggingstrategies)" : [ String, ... ], "[ManifestServiceInteractionLog](#cfn-mediatailor-playbackconfiguration-logconfiguration-manifestserviceinteractionlog)" : ManifestServiceInteractionLog, "[PercentEnabled](#cfn-mediatailor-playbackconfiguration-logconfiguration-percentenabled)" : Integer } ``` ### YAML ``` [AdsInteractionLog](#cfn-mediatailor-playbackconfiguration-logconfiguration-adsinteractionlog): AdsInteractionLog [EnabledLoggingStrategies](#cfn-mediatailor-playbackconfiguration-logconfiguration-enabledloggingstrategies): - String [ManifestServiceInteractionLog](#cfn-mediatailor-playbackconfiguration-logconfiguration-manifestserviceinteractionlog): ManifestServiceInteractionLog [PercentEnabled](#cfn-mediatailor-playbackconfiguration-logconfiguration-percentenabled): Integer ``` ## Properties `AdsInteractionLog` Settings for customizing what events are included in logs for interactions with the ad decision server (ADS). *Required*: No *Type*: [AdsInteractionLog](aws-properties-mediatailor-playbackconfiguration-adsinteractionlog.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `EnabledLoggingStrategies` The method used for collecting logs from AWS Elemental MediaTailor. `LEGACY_CLOUDWATCH` indicates that MediaTailor is sending logs directly to Amazon CloudWatch Logs. `VENDED_LOGS` indicates that MediaTailor is sending logs to CloudWatch, which then vends the logs to your destination of choice. Supported destinations are CloudWatch Logs log group, Amazon S3 bucket, and Amazon Data Firehose stream. *Required*: No *Type*: Array of String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `ManifestServiceInteractionLog` Settings for customizing what events are included in logs for interactions with the origin server. *Required*: No *Type*: [ManifestServiceInteractionLog](aws-properties-mediatailor-playbackconfiguration-manifestserviceinteractionlog.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `PercentEnabled` The percentage of session logs that MediaTailor sends to your configured log destination. For example, if your playback configuration has 1000 sessions and `percentEnabled` is set to `60`, MediaTailor sends logs for 600 of the sessions to CloudWatch Logs. MediaTailor decides at random which of the playback configuration sessions to send logs for. If you want to view logs for a specific session, you can use the [debug log mode](https://docs.aws.amazon.com/mediatailor/latest/ug/debug-log-mode.html). Valid values: `0` - `100` *Required*: Yes *Type*: Integer *Minimum*: `0` *Maximum*: `100` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration ManifestProcessingRules The configuration for manifest processing rules. Manifest processing rules enable customization of the personalized manifests created by MediaTailor. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[AdMarkerPassthrough](#cfn-mediatailor-playbackconfiguration-manifestprocessingrules-admarkerpassthrough)" : AdMarkerPassthrough } ``` ### YAML ``` [AdMarkerPassthrough](#cfn-mediatailor-playbackconfiguration-manifestprocessingrules-admarkerpassthrough): AdMarkerPassthrough ``` ## Properties `AdMarkerPassthrough` For HLS, when set to `true`, MediaTailor passes through `EXT-X-CUE-IN`, `EXT-X-CUE-OUT`, and `EXT-X-SPLICEPOINT-SCTE35` ad markers from the origin manifest to the MediaTailor personalized manifest. No logic is applied to these ad markers. For example, if `EXT-X-CUE-OUT` has a value of `60`, but no ads are filled for that ad break, MediaTailor will not set the value to `0`. *Required*: No *Type*: [AdMarkerPassthrough](aws-properties-mediatailor-playbackconfiguration-admarkerpassthrough.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration ManifestServiceInteractionLog Settings for customizing what events are included in logs for interactions with the origin server. For more information about manifest service logs, including descriptions of the event types, see [MediaTailor manifest logs description and event types](https://docs.aws.amazon.com/mediatailor/latest/ug/log-types.html) in AWS Elemental MediaTailor User Guide. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[ExcludeEventTypes](#cfn-mediatailor-playbackconfiguration-manifestserviceinteractionlog-excludeeventtypes)" : [ String, ... ] } ``` ### YAML ``` [ExcludeEventTypes](#cfn-mediatailor-playbackconfiguration-manifestserviceinteractionlog-excludeeventtypes): - String ``` ## Properties `ExcludeEventTypes` Indicates that MediaTailor won't emit the selected events in the logs for playback sessions that are initialized with this configuration. *Required*: No *Type*: Array of String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::PlaybackConfiguration Tag The `Tag` property type specifies Property description not available. for an [AWS::MediaTailor::PlaybackConfiguration](aws-resource-mediatailor-playbackconfiguration.md). ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Key](#cfn-mediatailor-playbackconfiguration-tag-key)" : String, "[Value](#cfn-mediatailor-playbackconfiguration-tag-value)" : String } ``` ### YAML ``` [Key](#cfn-mediatailor-playbackconfiguration-tag-key): String [Value](#cfn-mediatailor-playbackconfiguration-tag-value): String ``` ## Properties `Key` Property description not available. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Value` Property description not available. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::SourceLocation A source location is a container for sources. For more information about source locations, see [Working with source locations](https://docs.aws.amazon.com/mediatailor/latest/ug/channel-assembly-source-locations.html) in the *MediaTailor User Guide*. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "Type" : "AWS::MediaTailor::SourceLocation", "Properties" : { "[AccessConfiguration](#cfn-mediatailor-sourcelocation-accessconfiguration)" : AccessConfiguration, "[DefaultSegmentDeliveryConfiguration](#cfn-mediatailor-sourcelocation-defaultsegmentdeliveryconfiguration)" : DefaultSegmentDeliveryConfiguration, "[HttpConfiguration](#cfn-mediatailor-sourcelocation-httpconfiguration)" : HttpConfiguration, "[SegmentDeliveryConfigurations](#cfn-mediatailor-sourcelocation-segmentdeliveryconfigurations)" : [ SegmentDeliveryConfiguration, ... ], "[SourceLocationName](#cfn-mediatailor-sourcelocation-sourcelocationname)" : String, "[Tags](#cfn-mediatailor-sourcelocation-tags)" : [ Tag, ... ] } } ``` ### YAML ``` Type: AWS::MediaTailor::SourceLocation Properties: [AccessConfiguration](#cfn-mediatailor-sourcelocation-accessconfiguration): AccessConfiguration [DefaultSegmentDeliveryConfiguration](#cfn-mediatailor-sourcelocation-defaultsegmentdeliveryconfiguration): DefaultSegmentDeliveryConfiguration [HttpConfiguration](#cfn-mediatailor-sourcelocation-httpconfiguration): HttpConfiguration [SegmentDeliveryConfigurations](#cfn-mediatailor-sourcelocation-segmentdeliveryconfigurations): - SegmentDeliveryConfiguration [SourceLocationName](#cfn-mediatailor-sourcelocation-sourcelocationname): String [Tags](#cfn-mediatailor-sourcelocation-tags): - Tag ``` ## Properties `AccessConfiguration` The access configuration for the source location. *Required*: No *Type*: [AccessConfiguration](aws-properties-mediatailor-sourcelocation-accessconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `DefaultSegmentDeliveryConfiguration` The default segment delivery configuration. *Required*: No *Type*: [DefaultSegmentDeliveryConfiguration](aws-properties-mediatailor-sourcelocation-defaultsegmentdeliveryconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `HttpConfiguration` The HTTP configuration for the source location. *Required*: Yes *Type*: [HttpConfiguration](aws-properties-mediatailor-sourcelocation-httpconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `SegmentDeliveryConfigurations` The segment delivery configurations for the source location. *Required*: No *Type*: Array of [SegmentDeliveryConfiguration](aws-properties-mediatailor-sourcelocation-segmentdeliveryconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `SourceLocationName` The name of the source location. *Required*: Yes *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Tags` The tags assigned to the source location. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see [Tagging AWS Elemental MediaTailor Resources](https://docs.aws.amazon.com/mediatailor/latest/ug/tagging.html). *Required*: No *Type*: Array of [Tag](aws-properties-mediatailor-sourcelocation-tag.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) ## Return values ### Ref ### Fn::GetAtt #### `Arn` Property description not available. # AWS::MediaTailor::SourceLocation AccessConfiguration Access configuration parameters. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[AccessType](#cfn-mediatailor-sourcelocation-accessconfiguration-accesstype)" : String, "[SecretsManagerAccessTokenConfiguration](#cfn-mediatailor-sourcelocation-accessconfiguration-secretsmanageraccesstokenconfiguration)" : SecretsManagerAccessTokenConfiguration } ``` ### YAML ``` [AccessType](#cfn-mediatailor-sourcelocation-accessconfiguration-accesstype): String [SecretsManagerAccessTokenConfiguration](#cfn-mediatailor-sourcelocation-accessconfiguration-secretsmanageraccesstokenconfiguration): SecretsManagerAccessTokenConfiguration ``` ## Properties `AccessType` The type of authentication used to access content from `HttpConfiguration::BaseUrl` on your source location. Accepted value: `S3_SIGV4`. `S3_SIGV4` - AWS Signature Version 4 authentication for Amazon S3 hosted virtual-style access. If your source location base URL is an Amazon S3 bucket, MediaTailor can use AWS Signature Version 4 (SigV4) authentication to access the bucket where your source content is stored. Your MediaTailor source location baseURL must follow the S3 virtual hosted-style request URL format. For example, https://bucket-name.s3.Region.amazonaws.com/key-name. Before you can use `S3_SIGV4`, you must meet these requirements: • You must allow MediaTailor to access your S3 bucket by granting mediatailor.amazonaws.com principal access in IAM. For information about configuring access in IAM, see Access management in the IAM User Guide. • The mediatailor.amazonaws.com service principal must have permissions to read all top level manifests referenced by the VodSource packaging configurations. • The caller of the API must have s3:GetObject IAM permissions to read all top level manifests referenced by your MediaTailor VodSource packaging configurations. *Required*: No *Type*: String *Allowed values*: `S3_SIGV4 | SECRETS_MANAGER_ACCESS_TOKEN | AUTODETECT_SIGV4` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `SecretsManagerAccessTokenConfiguration` AWS Secrets Manager access token configuration parameters. *Required*: No *Type*: [SecretsManagerAccessTokenConfiguration](aws-properties-mediatailor-sourcelocation-secretsmanageraccesstokenconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::SourceLocation DefaultSegmentDeliveryConfiguration The optional configuration for a server that serves segments. Use this if you want the segment delivery server to be different from the source location server. For example, you can configure your source location server to be an origination server, such as MediaPackage, and the segment delivery server to be a content delivery network (CDN), such as CloudFront. If you don't specify a segment delivery server, then the source location server is used. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[BaseUrl](#cfn-mediatailor-sourcelocation-defaultsegmentdeliveryconfiguration-baseurl)" : String } ``` ### YAML ``` [BaseUrl](#cfn-mediatailor-sourcelocation-defaultsegmentdeliveryconfiguration-baseurl): String ``` ## Properties `BaseUrl` The hostname of the server that will be used to serve segments. This string must include the protocol, such as **https://**. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::SourceLocation HttpConfiguration The HTTP configuration for the source location. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[BaseUrl](#cfn-mediatailor-sourcelocation-httpconfiguration-baseurl)" : String } ``` ### YAML ``` [BaseUrl](#cfn-mediatailor-sourcelocation-httpconfiguration-baseurl): String ``` ## Properties `BaseUrl` The base URL for the source location host server. This string must include the protocol, such as **https://**. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::SourceLocation SecretsManagerAccessTokenConfiguration AWS Secrets Manager access token configuration parameters. For information about Secrets Manager access token authentication, see [Working with AWS Secrets Manager access token authentication](https://docs.aws.amazon.com/mediatailor/latest/ug/channel-assembly-access-configuration-access-token.html). ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[HeaderName](#cfn-mediatailor-sourcelocation-secretsmanageraccesstokenconfiguration-headername)" : String, "[SecretArn](#cfn-mediatailor-sourcelocation-secretsmanageraccesstokenconfiguration-secretarn)" : String, "[SecretStringKey](#cfn-mediatailor-sourcelocation-secretsmanageraccesstokenconfiguration-secretstringkey)" : String } ``` ### YAML ``` [HeaderName](#cfn-mediatailor-sourcelocation-secretsmanageraccesstokenconfiguration-headername): String [SecretArn](#cfn-mediatailor-sourcelocation-secretsmanageraccesstokenconfiguration-secretarn): String [SecretStringKey](#cfn-mediatailor-sourcelocation-secretsmanageraccesstokenconfiguration-secretstringkey): String ``` ## Properties `HeaderName` The name of the HTTP header used to supply the access token in requests to the source location. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `SecretArn` The Amazon Resource Name (ARN) of the AWS Secrets Manager secret that contains the access token. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `SecretStringKey` The AWS Secrets Manager[SecretString](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_CreateSecret.html#SecretsManager-CreateSecret-request-SecretString.html) key associated with the access token. MediaTailor uses the key to look up SecretString key and value pair containing the access token. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::SourceLocation SegmentDeliveryConfiguration The segment delivery configuration settings. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[BaseUrl](#cfn-mediatailor-sourcelocation-segmentdeliveryconfiguration-baseurl)" : String, "[Name](#cfn-mediatailor-sourcelocation-segmentdeliveryconfiguration-name)" : String } ``` ### YAML ``` [BaseUrl](#cfn-mediatailor-sourcelocation-segmentdeliveryconfiguration-baseurl): String [Name](#cfn-mediatailor-sourcelocation-segmentdeliveryconfiguration-name): String ``` ## Properties `BaseUrl` The base URL of the host or path of the segment delivery server that you're using to serve segments. This is typically a content delivery network (CDN). The URL can be absolute or relative. To use an absolute URL include the protocol, such as `https://example.com/some/path`. To use a relative URL specify the relative path, such as `/some/path*`. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Name` A unique identifier used to distinguish between multiple segment delivery configurations in a source location. *Required*: No *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::SourceLocation Tag The `Tag` property type specifies Property description not available. for an [AWS::MediaTailor::SourceLocation](aws-resource-mediatailor-sourcelocation.md). ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Key](#cfn-mediatailor-sourcelocation-tag-key)" : String, "[Value](#cfn-mediatailor-sourcelocation-tag-value)" : String } ``` ### YAML ``` [Key](#cfn-mediatailor-sourcelocation-tag-key): String [Value](#cfn-mediatailor-sourcelocation-tag-value): String ``` ## Properties `Key` Property description not available. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Value` Property description not available. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::VodSource The VOD source configuration parameters. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "Type" : "AWS::MediaTailor::VodSource", "Properties" : { "[HttpPackageConfigurations](#cfn-mediatailor-vodsource-httppackageconfigurations)" : [ HttpPackageConfiguration, ... ], "[SourceLocationName](#cfn-mediatailor-vodsource-sourcelocationname)" : String, "[Tags](#cfn-mediatailor-vodsource-tags)" : [ Tag, ... ], "[VodSourceName](#cfn-mediatailor-vodsource-vodsourcename)" : String } } ``` ### YAML ``` Type: AWS::MediaTailor::VodSource Properties: [HttpPackageConfigurations](#cfn-mediatailor-vodsource-httppackageconfigurations): - HttpPackageConfiguration [SourceLocationName](#cfn-mediatailor-vodsource-sourcelocationname): String [Tags](#cfn-mediatailor-vodsource-tags): - Tag [VodSourceName](#cfn-mediatailor-vodsource-vodsourcename): String ``` ## Properties `HttpPackageConfigurations` The HTTP package configurations for the VOD source. *Required*: Yes *Type*: Array of [HttpPackageConfiguration](aws-properties-mediatailor-vodsource-httppackageconfiguration.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `SourceLocationName` The name of the source location that the VOD source is associated with. *Required*: Yes *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) `Tags` The tags assigned to the VOD source. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see [Tagging AWS Elemental MediaTailor Resources](https://docs.aws.amazon.com/mediatailor/latest/ug/tagging.html). *Required*: No *Type*: Array of [Tag](aws-properties-mediatailor-vodsource-tag.md) *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `VodSourceName` The name of the VOD source. *Required*: Yes *Type*: String *Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) ## Return values ### Ref ### Fn::GetAtt #### `Arn` Property description not available. # AWS::MediaTailor::VodSource HttpPackageConfiguration The HTTP package configuration properties for the requested VOD source. ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Path](#cfn-mediatailor-vodsource-httppackageconfiguration-path)" : String, "[SourceGroup](#cfn-mediatailor-vodsource-httppackageconfiguration-sourcegroup)" : String, "[Type](#cfn-mediatailor-vodsource-httppackageconfiguration-type)" : String } ``` ### YAML ``` [Path](#cfn-mediatailor-vodsource-httppackageconfiguration-path): String [SourceGroup](#cfn-mediatailor-vodsource-httppackageconfiguration-sourcegroup): String [Type](#cfn-mediatailor-vodsource-httppackageconfiguration-type): String ``` ## Properties `Path` The relative path to the URL for this VOD source. This is combined with `SourceLocation::HttpConfiguration::BaseUrl` to form a valid URL. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `SourceGroup` The name of the source group. This has to match one of the `Channel::Outputs::SourceGroup`. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Type` The streaming protocol for this package configuration. Supported values are `HLS` and `DASH`. *Required*: Yes *Type*: String *Allowed values*: `DASH | HLS` *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) # AWS::MediaTailor::VodSource Tag The `Tag` property type specifies Property description not available. for an [AWS::MediaTailor::VodSource](aws-resource-mediatailor-vodsource.md). ## Syntax To declare this entity in your CloudFormation template, use the following syntax: ### JSON ``` { "[Key](#cfn-mediatailor-vodsource-tag-key)" : String, "[Value](#cfn-mediatailor-vodsource-tag-value)" : String } ``` ### YAML ``` [Key](#cfn-mediatailor-vodsource-tag-key): String [Value](#cfn-mediatailor-vodsource-tag-value): String ``` ## Properties `Key` Property description not available. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) `Value` Property description not available. *Required*: Yes *Type*: String *Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)