AWS::MediaLive::Channel - AWS CloudFormation

AWS::MediaLive::Channel

The AWS::MediaLive::Channel resource is a MediaLive resource type that creates a channel.

A MediaLive channel ingests and transcodes (decodes and encodes) source content from the inputs that are attached to that channel, and packages the new content into outputs.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "Type" : "AWS::MediaLive::Channel", "Properties" : { "ChannelClass" : String, "Destinations" : [ OutputDestination, ... ], "EncoderSettings" : EncoderSettings, "InputAttachments" : [ InputAttachment, ... ], "InputSpecification" : InputSpecification, "LogLevel" : String, "Name" : String, "RoleArn" : String, "Tags" : Json } }

Properties

ChannelClass

The class for this channel. STANDARD for a channel with two pipelines or SINGLE_PIPELINE for a channel with one pipeline.

Required: No

Type: String

Update requires: No interruption

Destinations

An ID for this destination information. Must be unique in the channel. This ID associates this destination information with its output group.

For most output groups, enter a value there, then enter the same value in the destinaton field in the output group.

For an RTMP output group or Multiplex output group, enter a value here, then enter the same value in the destination field in the output (not the output group).

For a MediaPackage output group, this ID is not used to make this association.

Required: No

Type: List of OutputDestination

Update requires: No interruption

EncoderSettings

You must include this element once in the channel. It contains information about all the output encodes (video, audio, captions), and about several channel-wide fetures.

Required: No

Type: EncoderSettings

Update requires: No interruption

InputAttachments

You must include this element. It contains the list of inputs to attach to the channel. The channel ingests and transcodes these inputs.

Required: No

Type: List of InputAttachment

Update requires: No interruption

InputSpecification

Include this element if you want to change the default values for the input specification.

Required: No

Type: InputSpecification

Update requires: No interruption

LogLevel

The log level to write to CloudWatch Logs.

Required: No

Type: String

Update requires: No interruption

Name

Name of channel.

Required: No

Type: String

Update requires: No interruption

RoleArn

An optional Amazon Resource Name (ARN) of the role to assume when running the Channel.

Required: No

Type: String

Update requires: No interruption

Tags

A collection of key-value pairs.

Required: No

Type: Json

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the name of the channel.

For example: { "Ref": "myChannel" }

For more information about using the Ref function, see Ref.

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 Fn::GetAtt.

Arn

The ARN of the MediaLive channel. For example: arn:aws:medialive:us-west-1:111122223333:medialive:channel:1234567

Inputs

The inputs that are attached to this channel. The inputs are identified by their IDs (not by their names or their ARNs).