1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. medialive
  6. Node

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.76.0
published on Monday, Aug 24, 2026 by Pulumi
aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.76.0
published on Monday, Aug 24, 2026 by Pulumi

    Definition of AWS::MediaLive::Node Resource Type

    Create Node Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Node(name: string, args: NodeArgs, opts?: CustomResourceOptions);
    @overload
    def Node(resource_name: str,
             args: NodeArgs,
             opts: Optional[ResourceOptions] = None)
    
    @overload
    def Node(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             cluster_id: Optional[str] = None,
             name: Optional[str] = None,
             node_interface_mappings: Optional[Sequence[NodeInterfaceMappingArgs]] = None,
             role: Optional[NodeRole] = None,
             sdi_source_mappings: Optional[Sequence[NodeSdiSourceMappingArgs]] = None,
             tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewNode(ctx *Context, name string, args NodeArgs, opts ...ResourceOption) (*Node, error)
    public Node(string name, NodeArgs args, CustomResourceOptions? opts = null)
    public Node(String name, NodeArgs args)
    public Node(String name, NodeArgs args, CustomResourceOptions options)
    
    type: aws-native:medialive:Node
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_medialive_node" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args NodeArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args NodeArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args NodeArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args NodeArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args NodeArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Node Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Node resource accepts the following input properties:

    ClusterId string
    The ID of the Cluster that the Node belongs to.
    Name string
    The user-specified name of the Node.
    NodeInterfaceMappings List<Pulumi.AwsNative.MediaLive.Inputs.NodeInterfaceMapping>
    An array of interface mappings for the Node.
    Role Pulumi.AwsNative.MediaLive.NodeRole
    SdiSourceMappings List<Pulumi.AwsNative.MediaLive.Inputs.NodeSdiSourceMapping>
    An array of SDI source mappings.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    A collection of key-value pairs.
    ClusterId string
    The ID of the Cluster that the Node belongs to.
    Name string
    The user-specified name of the Node.
    NodeInterfaceMappings []NodeInterfaceMappingArgs
    An array of interface mappings for the Node.
    Role NodeRole
    SdiSourceMappings []NodeSdiSourceMappingArgs
    An array of SDI source mappings.
    Tags TagArgs
    A collection of key-value pairs.
    cluster_id string
    The ID of the Cluster that the Node belongs to.
    name string
    The user-specified name of the Node.
    node_interface_mappings list(object)
    An array of interface mappings for the Node.
    role "BACKUP" | "ACTIVE"
    sdi_source_mappings list(object)
    An array of SDI source mappings.
    tags list(object)
    A collection of key-value pairs.
    clusterId String
    The ID of the Cluster that the Node belongs to.
    name String
    The user-specified name of the Node.
    nodeInterfaceMappings List<NodeInterfaceMapping>
    An array of interface mappings for the Node.
    role NodeRole
    sdiSourceMappings List<NodeSdiSourceMapping>
    An array of SDI source mappings.
    tags List<Tag>
    A collection of key-value pairs.
    clusterId string
    The ID of the Cluster that the Node belongs to.
    name string
    The user-specified name of the Node.
    nodeInterfaceMappings NodeInterfaceMapping[]
    An array of interface mappings for the Node.
    role NodeRole
    sdiSourceMappings NodeSdiSourceMapping[]
    An array of SDI source mappings.
    tags Tag[]
    A collection of key-value pairs.
    cluster_id str
    The ID of the Cluster that the Node belongs to.
    name str
    The user-specified name of the Node.
    node_interface_mappings Sequence[NodeInterfaceMappingArgs]
    An array of interface mappings for the Node.
    role NodeRole
    sdi_source_mappings Sequence[NodeSdiSourceMappingArgs]
    An array of SDI source mappings.
    tags Sequence[TagArgs]
    A collection of key-value pairs.
    clusterId String
    The ID of the Cluster that the Node belongs to.
    name String
    The user-specified name of the Node.
    nodeInterfaceMappings List<Property Map>
    An array of interface mappings for the Node.
    role "BACKUP" | "ACTIVE"
    sdiSourceMappings List<Property Map>
    An array of SDI source mappings.
    tags List<Property Map>
    A collection of key-value pairs.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Node resource produces the following output properties:

    Arn string
    The ARN of the Node. It is automatically assigned when the Node is created.
    AwsId string
    The unique ID of the Node. Unique in the Cluster. The ID is the resource-id portion of the ARN.
    ChannelPlacementGroups List<string>
    An array of IDs. Each ID is one ChannelPlacementGroup that is associated with this Node.
    ConnectionState Pulumi.AwsNative.MediaLive.NodeConnectionState
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceArn string
    The ARN of the EC2 instance hosting the Node.
    State Pulumi.AwsNative.MediaLive.NodeState
    Arn string
    The ARN of the Node. It is automatically assigned when the Node is created.
    AwsId string
    The unique ID of the Node. Unique in the Cluster. The ID is the resource-id portion of the ARN.
    ChannelPlacementGroups []string
    An array of IDs. Each ID is one ChannelPlacementGroup that is associated with this Node.
    ConnectionState NodeConnectionState
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceArn string
    The ARN of the EC2 instance hosting the Node.
    State NodeStateEnum
    arn string
    The ARN of the Node. It is automatically assigned when the Node is created.
    aws_id string
    The unique ID of the Node. Unique in the Cluster. The ID is the resource-id portion of the ARN.
    channel_placement_groups list(string)
    An array of IDs. Each ID is one ChannelPlacementGroup that is associated with this Node.
    connection_state "CONNECTED" | "DISCONNECTED"
    id string
    The provider-assigned unique ID for this managed resource.
    instance_arn string
    The ARN of the EC2 instance hosting the Node.
    state "CREATED" | "REGISTERING" | "READY_TO_ACTIVATE" | "REGISTRATION_FAILED" | "ACTIVATION_FAILED" | "ACTIVE" | "READY" | "IN_USE" | "DEREGISTERING" | "DRAINING" | "DEREGISTRATION_FAILED" | "DEREGISTERED"
    arn String
    The ARN of the Node. It is automatically assigned when the Node is created.
    awsId String
    The unique ID of the Node. Unique in the Cluster. The ID is the resource-id portion of the ARN.
    channelPlacementGroups List<String>
    An array of IDs. Each ID is one ChannelPlacementGroup that is associated with this Node.
    connectionState NodeConnectionState
    id String
    The provider-assigned unique ID for this managed resource.
    instanceArn String
    The ARN of the EC2 instance hosting the Node.
    state NodeState
    arn string
    The ARN of the Node. It is automatically assigned when the Node is created.
    awsId string
    The unique ID of the Node. Unique in the Cluster. The ID is the resource-id portion of the ARN.
    channelPlacementGroups string[]
    An array of IDs. Each ID is one ChannelPlacementGroup that is associated with this Node.
    connectionState NodeConnectionState
    id string
    The provider-assigned unique ID for this managed resource.
    instanceArn string
    The ARN of the EC2 instance hosting the Node.
    state NodeState
    arn str
    The ARN of the Node. It is automatically assigned when the Node is created.
    aws_id str
    The unique ID of the Node. Unique in the Cluster. The ID is the resource-id portion of the ARN.
    channel_placement_groups Sequence[str]
    An array of IDs. Each ID is one ChannelPlacementGroup that is associated with this Node.
    connection_state NodeConnectionState
    id str
    The provider-assigned unique ID for this managed resource.
    instance_arn str
    The ARN of the EC2 instance hosting the Node.
    state NodeState
    arn String
    The ARN of the Node. It is automatically assigned when the Node is created.
    awsId String
    The unique ID of the Node. Unique in the Cluster. The ID is the resource-id portion of the ARN.
    channelPlacementGroups List<String>
    An array of IDs. Each ID is one ChannelPlacementGroup that is associated with this Node.
    connectionState "CONNECTED" | "DISCONNECTED"
    id String
    The provider-assigned unique ID for this managed resource.
    instanceArn String
    The ARN of the EC2 instance hosting the Node.
    state "CREATED" | "REGISTERING" | "READY_TO_ACTIVATE" | "REGISTRATION_FAILED" | "ACTIVATION_FAILED" | "ACTIVE" | "READY" | "IN_USE" | "DEREGISTERING" | "DRAINING" | "DEREGISTRATION_FAILED" | "DEREGISTERED"

    Supporting Types

    NodeConnectionState, NodeConnectionStateArgs

    Connected
    CONNECTED
    Disconnected
    DISCONNECTED
    NodeConnectionStateConnected
    CONNECTED
    NodeConnectionStateDisconnected
    DISCONNECTED
    "CONNECTED"
    CONNECTED
    "DISCONNECTED"
    DISCONNECTED
    Connected
    CONNECTED
    Disconnected
    DISCONNECTED
    Connected
    CONNECTED
    Disconnected
    DISCONNECTED
    CONNECTED
    CONNECTED
    DISCONNECTED
    DISCONNECTED
    "CONNECTED"
    CONNECTED
    "DISCONNECTED"
    DISCONNECTED

    NodeInterfaceMapping, NodeInterfaceMappingArgs

    Node interface mapping.
    LogicalInterfaceName string
    The logical name for this interface.
    NetworkInterfaceMode Pulumi.AwsNative.MediaLive.NodeInterfaceMappingNetworkInterfaceMode
    The network interface mode.
    PhysicalInterfaceName string
    The physical interface name.
    LogicalInterfaceName string
    The logical name for this interface.
    NetworkInterfaceMode NodeInterfaceMappingNetworkInterfaceMode
    The network interface mode.
    PhysicalInterfaceName string
    The physical interface name.
    logical_interface_name string
    The logical name for this interface.
    network_interface_mode "NAT" | "BRIDGE"
    The network interface mode.
    physical_interface_name string
    The physical interface name.
    logicalInterfaceName String
    The logical name for this interface.
    networkInterfaceMode NodeInterfaceMappingNetworkInterfaceMode
    The network interface mode.
    physicalInterfaceName String
    The physical interface name.
    logicalInterfaceName string
    The logical name for this interface.
    networkInterfaceMode NodeInterfaceMappingNetworkInterfaceMode
    The network interface mode.
    physicalInterfaceName string
    The physical interface name.
    logical_interface_name str
    The logical name for this interface.
    network_interface_mode NodeInterfaceMappingNetworkInterfaceMode
    The network interface mode.
    physical_interface_name str
    The physical interface name.
    logicalInterfaceName String
    The logical name for this interface.
    networkInterfaceMode "NAT" | "BRIDGE"
    The network interface mode.
    physicalInterfaceName String
    The physical interface name.

    NodeInterfaceMappingNetworkInterfaceMode, NodeInterfaceMappingNetworkInterfaceModeArgs

    Nat
    NAT
    Bridge
    BRIDGE
    NodeInterfaceMappingNetworkInterfaceModeNat
    NAT
    NodeInterfaceMappingNetworkInterfaceModeBridge
    BRIDGE
    "NAT"
    NAT
    "BRIDGE"
    BRIDGE
    Nat
    NAT
    Bridge
    BRIDGE
    Nat
    NAT
    Bridge
    BRIDGE
    NAT
    NAT
    BRIDGE
    BRIDGE
    "NAT"
    NAT
    "BRIDGE"
    BRIDGE

    NodeRole, NodeRoleArgs

    Backup
    BACKUP
    Active
    ACTIVE
    NodeRoleBackup
    BACKUP
    NodeRoleActive
    ACTIVE
    "BACKUP"
    BACKUP
    "ACTIVE"
    ACTIVE
    Backup
    BACKUP
    Active
    ACTIVE
    Backup
    BACKUP
    Active
    ACTIVE
    BACKUP
    BACKUP
    ACTIVE
    ACTIVE
    "BACKUP"
    BACKUP
    "ACTIVE"
    ACTIVE

    NodeSdiSourceMapping, NodeSdiSourceMappingArgs

    SDI source mapping.
    CardNumber int
    The card number.
    ChannelNumber int
    The channel number.
    SdiSource string
    The SDI source.
    CardNumber int
    The card number.
    ChannelNumber int
    The channel number.
    SdiSource string
    The SDI source.
    card_number number
    The card number.
    channel_number number
    The channel number.
    sdi_source string
    The SDI source.
    cardNumber Integer
    The card number.
    channelNumber Integer
    The channel number.
    sdiSource String
    The SDI source.
    cardNumber number
    The card number.
    channelNumber number
    The channel number.
    sdiSource string
    The SDI source.
    card_number int
    The card number.
    channel_number int
    The channel number.
    sdi_source str
    The SDI source.
    cardNumber Number
    The card number.
    channelNumber Number
    The channel number.
    sdiSource String
    The SDI source.

    NodeState, NodeStateArgs

    Created
    CREATED
    Registering
    REGISTERING
    ReadyToActivate
    READY_TO_ACTIVATE
    RegistrationFailed
    REGISTRATION_FAILED
    ActivationFailed
    ACTIVATION_FAILED
    Active
    ACTIVE
    Ready
    READY
    InUse
    IN_USE
    Deregistering
    DEREGISTERING
    Draining
    DRAINING
    DeregistrationFailed
    DEREGISTRATION_FAILED
    Deregistered
    DEREGISTERED
    NodeStateCreated
    CREATED
    NodeStateRegistering
    REGISTERING
    NodeStateReadyToActivate
    READY_TO_ACTIVATE
    NodeStateRegistrationFailed
    REGISTRATION_FAILED
    NodeStateActivationFailed
    ACTIVATION_FAILED
    NodeStateActive
    ACTIVE
    NodeStateReady
    READY
    NodeStateInUse
    IN_USE
    NodeStateDeregistering
    DEREGISTERING
    NodeStateDraining
    DRAINING
    NodeStateDeregistrationFailed
    DEREGISTRATION_FAILED
    NodeStateDeregistered
    DEREGISTERED
    "CREATED"
    CREATED
    "REGISTERING"
    REGISTERING
    "READY_TO_ACTIVATE"
    READY_TO_ACTIVATE
    "REGISTRATION_FAILED"
    REGISTRATION_FAILED
    "ACTIVATION_FAILED"
    ACTIVATION_FAILED
    "ACTIVE"
    ACTIVE
    "READY"
    READY
    "IN_USE"
    IN_USE
    "DEREGISTERING"
    DEREGISTERING
    "DRAINING"
    DRAINING
    "DEREGISTRATION_FAILED"
    DEREGISTRATION_FAILED
    "DEREGISTERED"
    DEREGISTERED
    Created
    CREATED
    Registering
    REGISTERING
    ReadyToActivate
    READY_TO_ACTIVATE
    RegistrationFailed
    REGISTRATION_FAILED
    ActivationFailed
    ACTIVATION_FAILED
    Active
    ACTIVE
    Ready
    READY
    InUse
    IN_USE
    Deregistering
    DEREGISTERING
    Draining
    DRAINING
    DeregistrationFailed
    DEREGISTRATION_FAILED
    Deregistered
    DEREGISTERED
    Created
    CREATED
    Registering
    REGISTERING
    ReadyToActivate
    READY_TO_ACTIVATE
    RegistrationFailed
    REGISTRATION_FAILED
    ActivationFailed
    ACTIVATION_FAILED
    Active
    ACTIVE
    Ready
    READY
    InUse
    IN_USE
    Deregistering
    DEREGISTERING
    Draining
    DRAINING
    DeregistrationFailed
    DEREGISTRATION_FAILED
    Deregistered
    DEREGISTERED
    CREATED
    CREATED
    REGISTERING
    REGISTERING
    READY_TO_ACTIVATE
    READY_TO_ACTIVATE
    REGISTRATION_FAILED
    REGISTRATION_FAILED
    ACTIVATION_FAILED
    ACTIVATION_FAILED
    ACTIVE
    ACTIVE
    READY
    READY
    IN_USE
    IN_USE
    DEREGISTERING
    DEREGISTERING
    DRAINING
    DRAINING
    DEREGISTRATION_FAILED
    DEREGISTRATION_FAILED
    DEREGISTERED
    DEREGISTERED
    "CREATED"
    CREATED
    "REGISTERING"
    REGISTERING
    "READY_TO_ACTIVATE"
    READY_TO_ACTIVATE
    "REGISTRATION_FAILED"
    REGISTRATION_FAILED
    "ACTIVATION_FAILED"
    ACTIVATION_FAILED
    "ACTIVE"
    ACTIVE
    "READY"
    READY
    "IN_USE"
    IN_USE
    "DEREGISTERING"
    DEREGISTERING
    "DRAINING"
    DRAINING
    "DEREGISTRATION_FAILED"
    DEREGISTRATION_FAILED
    "DEREGISTERED"
    DEREGISTERED

    Tag, TagArgs

    A set of tags to apply to the resource.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.76.0
    published on Monday, Aug 24, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial