AWS CloudFormation
User Guide (Version )

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

AWS::MediaLive::Input

The AWS::MediaLive::Input resource is a MediaLive resource type that creates an input.

A MediaLive input holds information that describes how the MediaLive channel is connected to the upstream system that is providing the source content that is to be transcoded.

Syntax

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

JSON

{ "Type" : "AWS::MediaLive::Input", "Properties" : { "Destinations" : [ InputDestinationRequest, ... ], "InputSecurityGroups" : [ String, ... ], "MediaConnectFlows" : [ MediaConnectFlowRequest, ... ], "Name" : String, "RoleArn" : String, "Sources" : [ InputSourceRequest, ... ], "Tags" : Json, "Type" : String, "Vpc" : InputVpcRequest } }

YAML

Type: AWS::MediaLive::Input Properties: Destinations: - InputDestinationRequest InputSecurityGroups: - String MediaConnectFlows: - MediaConnectFlowRequest Name: String RoleArn: String Sources: - InputSourceRequest Tags: Json Type: String Vpc: InputVpcRequest

Properties

Destinations

The destination settings for push types of inputs. If the input is a pull type, these settings don't apply.

Required: No

Type: List of InputDestinationRequest

Update requires: No interruption

InputSecurityGroups

The list of input security groups (referenced by IDs) to attach to the input if the input is a push type.

Required: No

Type: List of String

Update requires: No interruption

MediaConnectFlows

Settings that apply only if the input is a MediaConnect input.

Required: No

Type: List of MediaConnectFlowRequest

Update requires: No interruption

Name

A name for the input.

Required: No

Type: String

Update requires: No interruption

RoleArn

The IAM role for MediaLive to assume when creating a MediaConnect input or Amazon VPC input. This doesn't apply to other types of inputs. The role is identified by its ARN.

Required: No

Type: String

Update requires: No interruption

Sources

The source settings for a pull type of input. These settings don't apply if the input is a push type.

Required: No

Type: List of InputSourceRequest

Update requires: No interruption

Tags

A collection of tags for this input. Each tag is a key-value pair.

Required: No

Type: Json

Update requires: No interruption

Type

The type for this input.

Required: No

Type: String

Update requires: Replacement

Vpc

Settings that apply only if the input is an Amazon VPC input.

Required: No

Type: InputVpcRequest

Update requires: Replacement

Return Values

Ref

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

For example: { "Ref": "myInput" }

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 input. For example: arn:aws:medialive:us-west-1:111122223333:medialive:input:1234567. MediaLive creates this ARN when it creates the input.

Destinations

For a push input, the destination or destinations for the input. The destinations are the IP addresses on MediaLive where the upstream system pushes the content to for this input. MediaLive creates these IP addresses when it creates the input.

Sources

For a pull input, the source or sources for the input. The sources are the IP addresses on the upstream system where MediaLive pulls the content from for this input. You included these IP addresses in the create request.