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, ... ]
, "InputDevices" :[ InputDeviceSettings, ... ]
, "InputNetworkLocation" :String
, "InputSecurityGroups" :[ String, ... ]
, "MediaConnectFlows" :[ MediaConnectFlowRequest, ... ]
, "MulticastSettings" :MulticastSettingsCreateRequest
, "Name" :String
, "RoleArn" :String
, "Sources" :[ InputSourceRequest, ... ]
, "SrtSettings" :SrtSettingsRequest
, "Tags" :[
, "Type" :Tag
, ... ]String
, "Vpc" :InputVpcRequest
} }
YAML
Type: AWS::MediaLive::Input Properties: Destinations:
- InputDestinationRequest
InputDevices:- InputDeviceSettings
InputNetworkLocation:String
InputSecurityGroups:- String
MediaConnectFlows:- MediaConnectFlowRequest
MulticastSettings:MulticastSettingsCreateRequest
Name:String
RoleArn:String
Sources:- InputSourceRequest
SrtSettings:SrtSettingsRequest
Tags:-
Type:Tag
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
InputNetworkLocation
Property description not available.
Required: No
Type: String
Update requires: Replacement
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
MulticastSettings
Property description not available.
Required: No
Type: MulticastSettingsCreateRequest
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
SrtSettings
Property description not available.
Required: No
Type: SrtSettingsRequest
Update requires: No interruption
-
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.