AWS::MediaLive::Input - Amazon CloudFormation
SyntaxPropertiesReturn values
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

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 Amazon CloudFormation template, use the following syntax:

JSON

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

Properties

Destinations

Settings that apply only if the input is a push type of input.

Required: No

Type: Array of InputDestinationRequest

Update requires: No interruption

InputDevices

Settings that apply only if the input is an Elemental Link input.

Required: No

Type: Array of InputDeviceSettings

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: Array of String

Update requires: No interruption

MediaConnectFlows

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

Required: No

Type: Array 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

Settings that apply only if the input is a pull type of input.

Required: No

Type: Array of InputSourceRequest

Update requires: No interruption

Tags

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

Required: No

Type: Array of Tag

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 push input where the source is on Amazon VPC.

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 MediaLive id 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 the destination or destinations for the input. The destinations are the URLs of locations on MediaLive where the upstream system pushes the content to, for this input. MediaLive creates these addresses when it creates the input.

Id

The unique ID for the device.

Sources

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