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::MediaLive::Input
<a name="aws-resource-medialive-input"></a>

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
<a name="aws-resource-medialive-input-syntax"></a>

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

### JSON
<a name="aws-resource-medialive-input-syntax.json"></a>

```
{
  "Type" : "AWS::MediaLive::Input",
  "Properties" : {
      "[Destinations](#cfn-medialive-input-destinations)" : [ InputDestinationRequest, ... ],
      "[InputDevices](#cfn-medialive-input-inputdevices)" : [ InputDeviceSettings, ... ],
      "[InputNetworkLocation](#cfn-medialive-input-inputnetworklocation)" : String,
      "[InputSecurityGroups](#cfn-medialive-input-inputsecuritygroups)" : [ String, ... ],
      "[MediaConnectFlows](#cfn-medialive-input-mediaconnectflows)" : [ MediaConnectFlowRequest, ... ],
      "[MulticastSettings](#cfn-medialive-input-multicastsettings)" : MulticastSettingsCreateRequest,
      "[Name](#cfn-medialive-input-name)" : String,
      "[RoleArn](#cfn-medialive-input-rolearn)" : String,
      "[RouterSettings](#cfn-medialive-input-routersettings)" : RouterSettings,
      "[SdiSources](#cfn-medialive-input-sdisources)" : [ String, ... ],
      "[Smpte2110ReceiverGroupSettings](#cfn-medialive-input-smpte2110receivergroupsettings)" : Smpte2110ReceiverGroupSettings,
      "[Sources](#cfn-medialive-input-sources)" : [ InputSourceRequest, ... ],
      "[SrtSettings](#cfn-medialive-input-srtsettings)" : SrtSettingsRequest,
      "[Tags](#cfn-medialive-input-tags)" : [ [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-resource-tags.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-resource-tags.html), ... ],
      "[Type](#cfn-medialive-input-type)" : String,
      "[Vpc](#cfn-medialive-input-vpc)" : InputVpcRequest
    }
}
```

### YAML
<a name="aws-resource-medialive-input-syntax.yaml"></a>

```
Type: AWS::MediaLive::Input
Properties:
  [Destinations](#cfn-medialive-input-destinations): 
    - InputDestinationRequest
  [InputDevices](#cfn-medialive-input-inputdevices): 
    - InputDeviceSettings
  [InputNetworkLocation](#cfn-medialive-input-inputnetworklocation): String
  [InputSecurityGroups](#cfn-medialive-input-inputsecuritygroups): 
    - String
  [MediaConnectFlows](#cfn-medialive-input-mediaconnectflows): 
    - MediaConnectFlowRequest
  [MulticastSettings](#cfn-medialive-input-multicastsettings): 
    MulticastSettingsCreateRequest
  [Name](#cfn-medialive-input-name): String
  [RoleArn](#cfn-medialive-input-rolearn): String
  [RouterSettings](#cfn-medialive-input-routersettings): 
    RouterSettings
  [SdiSources](#cfn-medialive-input-sdisources): 
    - String
  [Smpte2110ReceiverGroupSettings](#cfn-medialive-input-smpte2110receivergroupsettings): 
    Smpte2110ReceiverGroupSettings
  [Sources](#cfn-medialive-input-sources): 
    - InputSourceRequest
  [SrtSettings](#cfn-medialive-input-srtsettings): 
    SrtSettingsRequest
  [Tags](#cfn-medialive-input-tags): 
    - [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-resource-tags.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-resource-tags.html)
  [Type](#cfn-medialive-input-type): String
  [Vpc](#cfn-medialive-input-vpc): 
    InputVpcRequest
```

## Properties
<a name="aws-resource-medialive-input-properties"></a>

`Destinations`  <a name="cfn-medialive-input-destinations"></a>
Settings that apply only if the input is a push type of input.  
*Required*: No  
*Type*: Array of [InputDestinationRequest](aws-properties-medialive-input-inputdestinationrequest.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`InputDevices`  <a name="cfn-medialive-input-inputdevices"></a>
Settings that apply only if the input is an Elemental Link input.  
*Required*: No  
*Type*: Array of [InputDeviceSettings](aws-properties-medialive-input-inputdevicesettings.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`InputNetworkLocation`  <a name="cfn-medialive-input-inputnetworklocation"></a>
Property description not available.  
*Required*: No  
*Type*: String  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`InputSecurityGroups`  <a name="cfn-medialive-input-inputsecuritygroups"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`MediaConnectFlows`  <a name="cfn-medialive-input-mediaconnectflows"></a>
Settings that apply only if the input is a MediaConnect input.  
*Required*: No  
*Type*: Array of [MediaConnectFlowRequest](aws-properties-medialive-input-mediaconnectflowrequest.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`MulticastSettings`  <a name="cfn-medialive-input-multicastsettings"></a>
Property description not available.  
*Required*: No  
*Type*: [MulticastSettingsCreateRequest](aws-properties-medialive-input-multicastsettingscreaterequest.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Name`  <a name="cfn-medialive-input-name"></a>
A name for the input.  
*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)

`RoleArn`  <a name="cfn-medialive-input-rolearn"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`RouterSettings`  <a name="cfn-medialive-input-routersettings"></a>
Property description not available.  
*Required*: No  
*Type*: [RouterSettings](aws-properties-medialive-input-routersettings.md)  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`SdiSources`  <a name="cfn-medialive-input-sdisources"></a>
Property description not available.  
*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)

`Smpte2110ReceiverGroupSettings`  <a name="cfn-medialive-input-smpte2110receivergroupsettings"></a>
Property description not available.  
*Required*: No  
*Type*: [Smpte2110ReceiverGroupSettings](aws-properties-medialive-input-smpte2110receivergroupsettings.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Sources`  <a name="cfn-medialive-input-sources"></a>
Settings that apply only if the input is a pull type of input.   
*Required*: No  
*Type*: Array of [InputSourceRequest](aws-properties-medialive-input-inputsourcerequest.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`SrtSettings`  <a name="cfn-medialive-input-srtsettings"></a>
Property description not available.  
*Required*: No  
*Type*: [SrtSettingsRequest](aws-properties-medialive-input-srtsettingsrequest.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Tags`  <a name="cfn-medialive-input-tags"></a>
A collection of tags for this input. Each tag is a key-value pair.  
*Required*: No  
*Type*: Array of [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-resource-tags.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-resource-tags.html)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Type`  <a name="cfn-medialive-input-type"></a>
The type for this input.  
*Required*: No  
*Type*: String  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Vpc`  <a name="cfn-medialive-input-vpc"></a>
Settings that apply only if the input is an push input where the source is on Amazon VPC.   
*Required*: No  
*Type*: [InputVpcRequest](aws-properties-medialive-input-inputvpcrequest.md)  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

## Return values
<a name="aws-resource-medialive-input-return-values"></a>

### Ref
<a name="aws-resource-medialive-input-return-values-ref"></a>

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 [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html).

### Fn::GetAtt
<a name="aws-resource-medialive-input-return-values-fn--getatt"></a>

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

#### 
<a name="aws-resource-medialive-input-return-values-fn--getatt-fn--getatt"></a>

`Arn`  <a name="Arn-fn::getatt"></a>
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`  <a name="Destinations-fn::getatt"></a>
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`  <a name="Id-fn::getatt"></a>
The unique ID for the device.

`Sources`  <a name="Sources-fn::getatt"></a>
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.