AWS::MediaLive::Input - AWS CloudFormation

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

Read-only. Specifies the URLs for a push input. The input is pushing to these addresses in order to deliver to MediaLive. You don't set these values.

Required: No

Type: List of InputDestinationRequest

Update requires: No interruption

InputSecurityGroups

A list of security groups referenced by IDs to attach to the input.

Required: No

Type: List of String

Update requires: No interruption

MediaConnectFlows

Include this element only for a MEDIACONNECT type of input. A list of the MediaConnect Flows that you want to use in this input. You can specify as few as one Flow and presently, as many as two. The only requirement is when you have more than one is that each Flow is in a separate Availability Zone as this ensures your EML input is redundant to AZ issues.

Required: No

Type: List of MediaConnectFlowRequest

Update requires: No interruption

Name

Name of the input. Required.

Required: No

Type: String

Update requires: No interruption

RoleArn

The Amazon Resource Name (ARN) of the role this input assumes during and after creation.

Required: No

Type: String

Update requires: No interruption

Sources

Include this element only if the input is a pull input. Specifies the source URLs for the input.

Required: No

Type: List of InputSourceRequest

Update requires: No interruption

Tags

A collection of key-value pairs.

Required: No

Type: Json

Update requires: No interruption

Type

You must include this element. It sets the type of the input, which then determines which other elements you must include in this CreateInput element.

Required: No

Type: String

Update requires: Replacement

Vpc

Include this element only for a VPC type of 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 ID of the input.

For example: { "Ref": "1234567" }

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.

The IP addresses are in a string format that shows a list. For example [rtp://203.0.113.28:5000, rtp://203.0.113.33:5005]

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 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.