AWS MediaConnect

2026/04/09 - AWS MediaConnect - 5 updated api methods

Changes  Adds support for MediaLive Channel-type Router Inputs.

BatchGetRouterInput (updated) Link ¶
Changes (response)
{'RouterInputs': {'Configuration': {'MediaLiveChannel': {'MediaLiveChannelArn': 'string',
                                                         'MediaLiveChannelOutputName': 'string',
                                                         'MediaLivePipelineId': 'PIPELINE_0 '
                                                                                '| '
                                                                                'PIPELINE_1',
                                                         'SourceTransitDecryption': {'EncryptionKeyConfiguration': {'Automatic': {},
                                                                                                                    'SecretsManager': {'RoleArn': 'string',
                                                                                                                                       'SecretArn': 'string'}},
                                                                                     'EncryptionKeyType': 'SECRETS_MANAGER '
                                                                                                          '| '
                                                                                                          'AUTOMATIC'}}},
                  'InputType': {'MEDIALIVE_CHANNEL'},
                  'StreamDetails': {'MediaLiveChannel': {}}}}

Retrieves information about multiple router inputs in AWS Elemental MediaConnect.

See also: AWS API Documentation

Request Syntax

client.batch_get_router_input(
    Arns=[
        'string',
    ]
)
type Arns:

list

param Arns:

[REQUIRED]

The Amazon Resource Names (ARNs) of the router inputs you want to retrieve information about.

  • (string) --

rtype:

dict

returns:

Response Syntax

{
    'RouterInputs': [
        {
            'Name': 'string',
            'Arn': 'string',
            'Id': 'string',
            'State': 'CREATING'|'STANDBY'|'STARTING'|'ACTIVE'|'STOPPING'|'DELETING'|'UPDATING'|'ERROR'|'RECOVERING'|'MIGRATING',
            'InputType': 'STANDARD'|'FAILOVER'|'MERGE'|'MEDIACONNECT_FLOW'|'MEDIALIVE_CHANNEL',
            'Configuration': {
                'Standard': {
                    'NetworkInterfaceArn': 'string',
                    'ProtocolConfiguration': {
                        'Rist': {
                            'Port': 123,
                            'RecoveryLatencyMilliseconds': 123
                        },
                        'SrtListener': {
                            'Port': 123,
                            'MinimumLatencyMilliseconds': 123,
                            'DecryptionConfiguration': {
                                'EncryptionKey': {
                                    'SecretArn': 'string',
                                    'RoleArn': 'string'
                                }
                            }
                        },
                        'SrtCaller': {
                            'SourceAddress': 'string',
                            'SourcePort': 123,
                            'MinimumLatencyMilliseconds': 123,
                            'StreamId': 'string',
                            'DecryptionConfiguration': {
                                'EncryptionKey': {
                                    'SecretArn': 'string',
                                    'RoleArn': 'string'
                                }
                            }
                        },
                        'Rtp': {
                            'Port': 123,
                            'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                        }
                    },
                    'Protocol': 'RTP'|'RIST'|'SRT_CALLER'|'SRT_LISTENER'
                },
                'MediaLiveChannel': {
                    'MediaLiveChannelArn': 'string',
                    'MediaLivePipelineId': 'PIPELINE_0'|'PIPELINE_1',
                    'MediaLiveChannelOutputName': 'string',
                    'SourceTransitDecryption': {
                        'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
                        'EncryptionKeyConfiguration': {
                            'SecretsManager': {
                                'SecretArn': 'string',
                                'RoleArn': 'string'
                            },
                            'Automatic': {}
                        }
                    }
                },
                'Failover': {
                    'NetworkInterfaceArn': 'string',
                    'ProtocolConfigurations': [
                        {
                            'Rist': {
                                'Port': 123,
                                'RecoveryLatencyMilliseconds': 123
                            },
                            'SrtListener': {
                                'Port': 123,
                                'MinimumLatencyMilliseconds': 123,
                                'DecryptionConfiguration': {
                                    'EncryptionKey': {
                                        'SecretArn': 'string',
                                        'RoleArn': 'string'
                                    }
                                }
                            },
                            'SrtCaller': {
                                'SourceAddress': 'string',
                                'SourcePort': 123,
                                'MinimumLatencyMilliseconds': 123,
                                'StreamId': 'string',
                                'DecryptionConfiguration': {
                                    'EncryptionKey': {
                                        'SecretArn': 'string',
                                        'RoleArn': 'string'
                                    }
                                }
                            },
                            'Rtp': {
                                'Port': 123,
                                'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                            }
                        },
                    ],
                    'SourcePriorityMode': 'NO_PRIORITY'|'PRIMARY_SECONDARY',
                    'PrimarySourceIndex': 123
                },
                'MediaConnectFlow': {
                    'FlowArn': 'string',
                    'FlowOutputArn': 'string',
                    'SourceTransitDecryption': {
                        'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
                        'EncryptionKeyConfiguration': {
                            'SecretsManager': {
                                'SecretArn': 'string',
                                'RoleArn': 'string'
                            },
                            'Automatic': {}
                        }
                    }
                },
                'Merge': {
                    'NetworkInterfaceArn': 'string',
                    'ProtocolConfigurations': [
                        {
                            'Rtp': {
                                'Port': 123,
                                'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                            },
                            'Rist': {
                                'Port': 123,
                                'RecoveryLatencyMilliseconds': 123
                            }
                        },
                    ],
                    'MergeRecoveryWindowMilliseconds': 123
                }
            },
            'RoutedOutputs': 123,
            'MaximumRoutedOutputs': 123,
            'RegionName': 'string',
            'AvailabilityZone': 'string',
            'MaximumBitrate': 123,
            'Tier': 'INPUT_100'|'INPUT_50'|'INPUT_20',
            'RoutingScope': 'REGIONAL'|'GLOBAL',
            'CreatedAt': datetime(2015, 1, 1),
            'UpdatedAt': datetime(2015, 1, 1),
            'Messages': [
                {
                    'Code': 'string',
                    'Message': 'string'
                },
            ],
            'TransitEncryption': {
                'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
                'EncryptionKeyConfiguration': {
                    'SecretsManager': {
                        'SecretArn': 'string',
                        'RoleArn': 'string'
                    },
                    'Automatic': {}
                }
            },
            'Tags': {
                'string': 'string'
            },
            'StreamDetails': {
                'Standard': {
                    'SourceIpAddress': 'string'
                },
                'MediaLiveChannel': {},
                'Failover': {
                    'SourceIndexZeroStreamDetails': {
                        'SourceIndex': 123,
                        'SourceIpAddress': 'string'
                    },
                    'SourceIndexOneStreamDetails': {
                        'SourceIndex': 123,
                        'SourceIpAddress': 'string'
                    }
                },
                'MediaConnectFlow': {},
                'Merge': {
                    'SourceIndexZeroStreamDetails': {
                        'SourceIndex': 123,
                        'SourceIpAddress': 'string'
                    },
                    'SourceIndexOneStreamDetails': {
                        'SourceIndex': 123,
                        'SourceIpAddress': 'string'
                    }
                }
            },
            'IpAddress': 'string',
            'MaintenanceType': 'PREFERRED_DAY_TIME'|'DEFAULT',
            'MaintenanceConfiguration': {
                'PreferredDayTime': {
                    'Day': 'MONDAY'|'TUESDAY'|'WEDNESDAY'|'THURSDAY'|'FRIDAY'|'SATURDAY'|'SUNDAY',
                    'Time': 'string'
                },
                'Default': {}
            },
            'MaintenanceScheduleType': 'WINDOW',
            'MaintenanceSchedule': {
                'Window': {
                    'Start': datetime(2015, 1, 1),
                    'End': datetime(2015, 1, 1),
                    'ScheduledTime': datetime(2015, 1, 1)
                }
            }
        },
    ],
    'Errors': [
        {
            'Arn': 'string',
            'Code': 'string',
            'Message': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • RouterInputs (list) --

      An array of router inputs that were successfully retrieved.

      • (dict) --

        A router input in AWS Elemental MediaConnect. A router input is a source of media content that can be routed to one or more router outputs.

        • Name (string) --

          The name of the router input.

        • Arn (string) --

          The Amazon Resource Name (ARN) of the router input.

        • Id (string) --

          The unique identifier of the router input.

        • State (string) --

          The current state of the router input.

        • InputType (string) --

          The type of the router input.

        • Configuration (dict) --

          The configuration settings for a router input.

          • Standard (dict) --

            The configuration settings for a standard router input, including the protocol, protocol-specific configuration, network interface, and availability zone.

            • NetworkInterfaceArn (string) --

              The Amazon Resource Name (ARN) of the network interface associated with the standard router input.

            • ProtocolConfiguration (dict) --

              The configuration settings for the protocol used by the standard router input.

              • Rist (dict) --

                The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

                • Port (integer) --

                  The port number used for the RIST protocol in the router input configuration.

                • RecoveryLatencyMilliseconds (integer) --

                  The recovery latency in milliseconds for the RIST protocol in the router input configuration.

              • SrtListener (dict) --

                The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in listener mode, including the port, minimum latency, and decryption key configuration.

                • Port (integer) --

                  The port number for the SRT protocol in listener mode.

                • MinimumLatencyMilliseconds (integer) --

                  The minimum latency in milliseconds for the SRT protocol in listener mode.

                • DecryptionConfiguration (dict) --

                  Specifies the decryption settings for an SRT listener input, including the encryption key configuration and associated parameters.

                  • EncryptionKey (dict) --

                    Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                    • SecretArn (string) --

                      The ARN of the Secrets Manager secret used for transit encryption.

                    • RoleArn (string) --

                      The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • SrtCaller (dict) --

                The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in caller mode, including the source address and port, minimum latency, stream ID, and decryption key configuration.

                • SourceAddress (string) --

                  The source IP address for the SRT protocol in caller mode.

                • SourcePort (integer) --

                  The source port number for the SRT protocol in caller mode.

                • MinimumLatencyMilliseconds (integer) --

                  The minimum latency in milliseconds for the SRT protocol in caller mode.

                • StreamId (string) --

                  The stream ID for the SRT protocol in caller mode.

                • DecryptionConfiguration (dict) --

                  Specifies the decryption settings for an SRT caller input, including the encryption key configuration and associated parameters.

                  • EncryptionKey (dict) --

                    Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                    • SecretArn (string) --

                      The ARN of the Secrets Manager secret used for transit encryption.

                    • RoleArn (string) --

                      The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • Rtp (dict) --

                The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

                • Port (integer) --

                  The port number used for the RTP protocol in the router input configuration.

                • ForwardErrorCorrection (string) --

                  The state of forward error correction for the RTP protocol in the router input configuration.

            • Protocol (string) --

              The protocol used by the standard router input.

          • MediaLiveChannel (dict) --

            Configuration settings for connecting a router input to a MediaLive channel output.

            • MediaLiveChannelArn (string) --

              The ARN of the MediaLive channel to connect to this router input.

            • MediaLivePipelineId (string) --

              The index of the MediaLive pipeline to connect to this router input.

            • MediaLiveChannelOutputName (string) --

              The name of the MediaLive channel output to connect to this router input.

            • SourceTransitDecryption (dict) --

              The encryption configuration that defines how content is encrypted during transit between MediaConnect Router and MediaLive. This configuration determines whether encryption keys are automatically managed by the service or manually managed through Secrets Manager.

              • EncryptionKeyType (string) --

                The type of encryption key to use for MediaLive transit encryption.

              • EncryptionKeyConfiguration (dict) --

                The configuration details for the MediaLive encryption key.

                • SecretsManager (dict) --

                  The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

                  • SecretArn (string) --

                    The ARN of the Secrets Manager secret used for transit encryption.

                  • RoleArn (string) --

                    The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

                • Automatic (dict) --

                  Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

          • Failover (dict) --

            Configuration settings for a failover router input that allows switching between two input sources.

            • NetworkInterfaceArn (string) --

              The ARN of the network interface to use for this failover router input.

            • ProtocolConfigurations (list) --

              A list of exactly two protocol configurations for the failover input sources. Both must use the same protocol type.

              • (dict) --

                Protocol configuration settings for failover router inputs.

                • Rist (dict) --

                  The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

                  • Port (integer) --

                    The port number used for the RIST protocol in the router input configuration.

                  • RecoveryLatencyMilliseconds (integer) --

                    The recovery latency in milliseconds for the RIST protocol in the router input configuration.

                • SrtListener (dict) --

                  The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in listener mode, including the port, minimum latency, and decryption key configuration.

                  • Port (integer) --

                    The port number for the SRT protocol in listener mode.

                  • MinimumLatencyMilliseconds (integer) --

                    The minimum latency in milliseconds for the SRT protocol in listener mode.

                  • DecryptionConfiguration (dict) --

                    Specifies the decryption settings for an SRT listener input, including the encryption key configuration and associated parameters.

                    • EncryptionKey (dict) --

                      Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                      • SecretArn (string) --

                        The ARN of the Secrets Manager secret used for transit encryption.

                      • RoleArn (string) --

                        The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

                • SrtCaller (dict) --

                  The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in caller mode, including the source address and port, minimum latency, stream ID, and decryption key configuration.

                  • SourceAddress (string) --

                    The source IP address for the SRT protocol in caller mode.

                  • SourcePort (integer) --

                    The source port number for the SRT protocol in caller mode.

                  • MinimumLatencyMilliseconds (integer) --

                    The minimum latency in milliseconds for the SRT protocol in caller mode.

                  • StreamId (string) --

                    The stream ID for the SRT protocol in caller mode.

                  • DecryptionConfiguration (dict) --

                    Specifies the decryption settings for an SRT caller input, including the encryption key configuration and associated parameters.

                    • EncryptionKey (dict) --

                      Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                      • SecretArn (string) --

                        The ARN of the Secrets Manager secret used for transit encryption.

                      • RoleArn (string) --

                        The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

                • Rtp (dict) --

                  The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

                  • Port (integer) --

                    The port number used for the RTP protocol in the router input configuration.

                  • ForwardErrorCorrection (string) --

                    The state of forward error correction for the RTP protocol in the router input configuration.

            • SourcePriorityMode (string) --

              The mode for determining source priority in failover configurations.

            • PrimarySourceIndex (integer) --

              The index (0 or 1) that specifies which source in the protocol configurations list is currently active. Used to control which of the two failover sources is currently selected. This field is ignored when sourcePriorityMode is set to NO_PRIORITY

          • MediaConnectFlow (dict) --

            Configuration settings for connecting a router input to a flow output.

            • FlowArn (string) --

              The ARN of the flow to connect to.

            • FlowOutputArn (string) --

              The ARN of the flow output to connect to this router input.

            • SourceTransitDecryption (dict) --

              The decryption configuration for the flow source when connected to this router input.

              • EncryptionKeyType (string) --

                The type of encryption key to use for flow transit encryption.

              • EncryptionKeyConfiguration (dict) --

                The configuration details for the encryption key.

                • SecretsManager (dict) --

                  The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

                  • SecretArn (string) --

                    The ARN of the Secrets Manager secret used for transit encryption.

                  • RoleArn (string) --

                    The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

                • Automatic (dict) --

                  Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

          • Merge (dict) --

            Configuration settings for a merge router input that combines two input sources.

            • NetworkInterfaceArn (string) --

              The ARN of the network interface to use for this merge router input.

            • ProtocolConfigurations (list) --

              A list of exactly two protocol configurations for the merge input sources. Both must use the same protocol type.

              • (dict) --

                Protocol configuration settings for merge router inputs.

                • Rtp (dict) --

                  The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

                  • Port (integer) --

                    The port number used for the RTP protocol in the router input configuration.

                  • ForwardErrorCorrection (string) --

                    The state of forward error correction for the RTP protocol in the router input configuration.

                • Rist (dict) --

                  The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

                  • Port (integer) --

                    The port number used for the RIST protocol in the router input configuration.

                  • RecoveryLatencyMilliseconds (integer) --

                    The recovery latency in milliseconds for the RIST protocol in the router input configuration.

            • MergeRecoveryWindowMilliseconds (integer) --

              The time window in milliseconds for merging the two input sources.

        • RoutedOutputs (integer) --

          The number of router outputs associated with the router input.

        • MaximumRoutedOutputs (integer) --

          The maximum number of outputs that can be simultaneously routed to this input.

        • RegionName (string) --

          The Amazon Web Services Region where the router input is located.

        • AvailabilityZone (string) --

          The Availability Zone of the router input.

        • MaximumBitrate (integer) --

          The maximum bitrate for the router input.

        • Tier (string) --

          The tier level of the router input.

        • RoutingScope (string) --

          Indicates whether the router input is configured for Regional or global routing.

        • CreatedAt (datetime) --

          The timestamp when the router input was created.

        • UpdatedAt (datetime) --

          The timestamp when the router input was last updated.

        • Messages (list) --

          The messages associated with the router input.

          • (dict) --

            A message associated with a router input, including a code and a message.

            • Code (string) --

              The code associated with the router input message.

            • Message (string) --

              The message text associated with the router input message.

        • TransitEncryption (dict) --

          The transit encryption settings for a router input.

          • EncryptionKeyType (string) --

            Specifies the type of encryption key to use for transit encryption.

          • EncryptionKeyConfiguration (dict) --

            Contains the configuration details for the encryption key used in transit encryption, including the key source and associated parameters.

            • SecretsManager (dict) --

              The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

              • SecretArn (string) --

                The ARN of the Secrets Manager secret used for transit encryption.

              • RoleArn (string) --

                The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

            • Automatic (dict) --

              Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

        • Tags (dict) --

          Key-value pairs that can be used to tag and organize this router input.

          • (string) --

            • (string) --

        • StreamDetails (dict) --

          Configuration details for the router input stream.

          • Standard (dict) --

            Configuration details for a standard router input stream type.

            • SourceIpAddress (string) --

              The source IP address for the standard router input stream.

          • MediaLiveChannel (dict) --

            Configuration details for a MediaLive channel when used as a router input source.

          • Failover (dict) --

            Configuration details for a failover router input that can automatically switch between two sources.

            • SourceIndexZeroStreamDetails (dict) --

              Configuration details for the primary source (index 0) in the failover setup.

              • SourceIndex (integer) --

                The index number (0 or 1) assigned to this source in the failover configuration.

              • SourceIpAddress (string) --

                The IP address of the source for this indexed stream.

            • SourceIndexOneStreamDetails (dict) --

              Configuration details for the secondary source (index 1) in the failover setup.

              • SourceIndex (integer) --

                The index number (0 or 1) assigned to this source in the failover configuration.

              • SourceIpAddress (string) --

                The IP address of the source for this indexed stream.

          • MediaConnectFlow (dict) --

            Configuration details for a MediaConnect flow when used as a router input source.

          • Merge (dict) --

            Configuration details for a merge router input that combines two input sources.

            • SourceIndexZeroStreamDetails (dict) --

              Configuration details for the first source (index 0) in the merge setup.

              • SourceIndex (integer) --

                The index number (0 or 1) assigned to this source in the merge configuration.

              • SourceIpAddress (string) --

                The IP address of the source for this indexed stream in the merge setup.

            • SourceIndexOneStreamDetails (dict) --

              Configuration details for the second source (index 1) in the merge setup.

              • SourceIndex (integer) --

                The index number (0 or 1) assigned to this source in the merge configuration.

              • SourceIpAddress (string) --

                The IP address of the source for this indexed stream in the merge setup.

        • IpAddress (string) --

          The IP address of the router input.

        • MaintenanceType (string) --

          The type of maintenance configuration applied to this router input.

        • MaintenanceConfiguration (dict) --

          The maintenance configuration settings applied to this router input.

          • PreferredDayTime (dict) --

            Preferred day and time maintenance configuration settings.

            • Day (string) --

              The preferred day for maintenance operations.

            • Time (string) --

              The preferred time for maintenance operations.

          • Default (dict) --

            Default maintenance configuration settings.

        • MaintenanceScheduleType (string) --

          The type of maintenance schedule currently in effect for this router input.

        • MaintenanceSchedule (dict) --

          The current maintenance schedule details for this router input.

          • Window (dict) --

            Defines a specific time window for maintenance operations.

            • Start (datetime) --

              The start time of the maintenance window.

            • End (datetime) --

              The end time of the maintenance window.

            • ScheduledTime (datetime) --

              The date and time when the maintenance window is scheduled to occur.

    • Errors (list) --

      An array of errors that occurred when retrieving the requested router inputs.

      • (dict) --

        An error that occurred when retrieving multiple router inputs in the BatchGetRouterInput operation, including the ARN, error code, and error message.

        • Arn (string) --

          The Amazon Resource Name (ARN) of the router input for which the error occurred.

        • Code (string) --

          The error code associated with the error.

        • Message (string) --

          A message describing the error.

CreateRouterInput (updated) Link ¶
Changes (request, response)
Request
{'Configuration': {'MediaLiveChannel': {'MediaLiveChannelArn': 'string',
                                        'MediaLiveChannelOutputName': 'string',
                                        'MediaLivePipelineId': 'PIPELINE_0 | '
                                                               'PIPELINE_1',
                                        'SourceTransitDecryption': {'EncryptionKeyConfiguration': {'Automatic': {},
                                                                                                   'SecretsManager': {'RoleArn': 'string',
                                                                                                                      'SecretArn': 'string'}},
                                                                    'EncryptionKeyType': 'SECRETS_MANAGER '
                                                                                         '| '
                                                                                         'AUTOMATIC'}}}}
Response
{'RouterInput': {'Configuration': {'MediaLiveChannel': {'MediaLiveChannelArn': 'string',
                                                        'MediaLiveChannelOutputName': 'string',
                                                        'MediaLivePipelineId': 'PIPELINE_0 '
                                                                               '| '
                                                                               'PIPELINE_1',
                                                        'SourceTransitDecryption': {'EncryptionKeyConfiguration': {'Automatic': {},
                                                                                                                   'SecretsManager': {'RoleArn': 'string',
                                                                                                                                      'SecretArn': 'string'}},
                                                                                    'EncryptionKeyType': 'SECRETS_MANAGER '
                                                                                                         '| '
                                                                                                         'AUTOMATIC'}}},
                 'InputType': {'MEDIALIVE_CHANNEL'},
                 'StreamDetails': {'MediaLiveChannel': {}}}}

Creates a new router input in AWS Elemental MediaConnect.

See also: AWS API Documentation

Request Syntax

client.create_router_input(
    Name='string',
    Configuration={
        'Standard': {
            'NetworkInterfaceArn': 'string',
            'ProtocolConfiguration': {
                'Rist': {
                    'Port': 123,
                    'RecoveryLatencyMilliseconds': 123
                },
                'SrtListener': {
                    'Port': 123,
                    'MinimumLatencyMilliseconds': 123,
                    'DecryptionConfiguration': {
                        'EncryptionKey': {
                            'SecretArn': 'string',
                            'RoleArn': 'string'
                        }
                    }
                },
                'SrtCaller': {
                    'SourceAddress': 'string',
                    'SourcePort': 123,
                    'MinimumLatencyMilliseconds': 123,
                    'StreamId': 'string',
                    'DecryptionConfiguration': {
                        'EncryptionKey': {
                            'SecretArn': 'string',
                            'RoleArn': 'string'
                        }
                    }
                },
                'Rtp': {
                    'Port': 123,
                    'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                }
            },
            'Protocol': 'RTP'|'RIST'|'SRT_CALLER'|'SRT_LISTENER'
        },
        'MediaLiveChannel': {
            'MediaLiveChannelArn': 'string',
            'MediaLivePipelineId': 'PIPELINE_0'|'PIPELINE_1',
            'MediaLiveChannelOutputName': 'string',
            'SourceTransitDecryption': {
                'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
                'EncryptionKeyConfiguration': {
                    'SecretsManager': {
                        'SecretArn': 'string',
                        'RoleArn': 'string'
                    },
                    'Automatic': {}

                }
            }
        },
        'Failover': {
            'NetworkInterfaceArn': 'string',
            'ProtocolConfigurations': [
                {
                    'Rist': {
                        'Port': 123,
                        'RecoveryLatencyMilliseconds': 123
                    },
                    'SrtListener': {
                        'Port': 123,
                        'MinimumLatencyMilliseconds': 123,
                        'DecryptionConfiguration': {
                            'EncryptionKey': {
                                'SecretArn': 'string',
                                'RoleArn': 'string'
                            }
                        }
                    },
                    'SrtCaller': {
                        'SourceAddress': 'string',
                        'SourcePort': 123,
                        'MinimumLatencyMilliseconds': 123,
                        'StreamId': 'string',
                        'DecryptionConfiguration': {
                            'EncryptionKey': {
                                'SecretArn': 'string',
                                'RoleArn': 'string'
                            }
                        }
                    },
                    'Rtp': {
                        'Port': 123,
                        'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                    }
                },
            ],
            'SourcePriorityMode': 'NO_PRIORITY'|'PRIMARY_SECONDARY',
            'PrimarySourceIndex': 123
        },
        'MediaConnectFlow': {
            'FlowArn': 'string',
            'FlowOutputArn': 'string',
            'SourceTransitDecryption': {
                'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
                'EncryptionKeyConfiguration': {
                    'SecretsManager': {
                        'SecretArn': 'string',
                        'RoleArn': 'string'
                    },
                    'Automatic': {}

                }
            }
        },
        'Merge': {
            'NetworkInterfaceArn': 'string',
            'ProtocolConfigurations': [
                {
                    'Rtp': {
                        'Port': 123,
                        'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                    },
                    'Rist': {
                        'Port': 123,
                        'RecoveryLatencyMilliseconds': 123
                    }
                },
            ],
            'MergeRecoveryWindowMilliseconds': 123
        }
    },
    MaximumBitrate=123,
    RoutingScope='REGIONAL'|'GLOBAL',
    Tier='INPUT_100'|'INPUT_50'|'INPUT_20',
    RegionName='string',
    AvailabilityZone='string',
    TransitEncryption={
        'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
        'EncryptionKeyConfiguration': {
            'SecretsManager': {
                'SecretArn': 'string',
                'RoleArn': 'string'
            },
            'Automatic': {}

        }
    },
    MaintenanceConfiguration={
        'PreferredDayTime': {
            'Day': 'MONDAY'|'TUESDAY'|'WEDNESDAY'|'THURSDAY'|'FRIDAY'|'SATURDAY'|'SUNDAY',
            'Time': 'string'
        },
        'Default': {}

    },
    Tags={
        'string': 'string'
    },
    ClientToken='string'
)
type Name:

string

param Name:

[REQUIRED]

The name of the router input.

type Configuration:

dict

param Configuration:

[REQUIRED]

The configuration settings for the router input, which can include the protocol, network interface, and other details.

  • Standard (dict) --

    The configuration settings for a standard router input, including the protocol, protocol-specific configuration, network interface, and availability zone.

    • NetworkInterfaceArn (string) -- [REQUIRED]

      The Amazon Resource Name (ARN) of the network interface associated with the standard router input.

    • ProtocolConfiguration (dict) -- [REQUIRED]

      The configuration settings for the protocol used by the standard router input.

      • Rist (dict) --

        The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

        • Port (integer) -- [REQUIRED]

          The port number used for the RIST protocol in the router input configuration.

        • RecoveryLatencyMilliseconds (integer) -- [REQUIRED]

          The recovery latency in milliseconds for the RIST protocol in the router input configuration.

      • SrtListener (dict) --

        The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in listener mode, including the port, minimum latency, and decryption key configuration.

        • Port (integer) -- [REQUIRED]

          The port number for the SRT protocol in listener mode.

        • MinimumLatencyMilliseconds (integer) -- [REQUIRED]

          The minimum latency in milliseconds for the SRT protocol in listener mode.

        • DecryptionConfiguration (dict) --

          Specifies the decryption settings for an SRT listener input, including the encryption key configuration and associated parameters.

          • EncryptionKey (dict) -- [REQUIRED]

            Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

            • SecretArn (string) -- [REQUIRED]

              The ARN of the Secrets Manager secret used for transit encryption.

            • RoleArn (string) -- [REQUIRED]

              The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

      • SrtCaller (dict) --

        The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in caller mode, including the source address and port, minimum latency, stream ID, and decryption key configuration.

        • SourceAddress (string) -- [REQUIRED]

          The source IP address for the SRT protocol in caller mode.

        • SourcePort (integer) -- [REQUIRED]

          The source port number for the SRT protocol in caller mode.

        • MinimumLatencyMilliseconds (integer) -- [REQUIRED]

          The minimum latency in milliseconds for the SRT protocol in caller mode.

        • StreamId (string) --

          The stream ID for the SRT protocol in caller mode.

        • DecryptionConfiguration (dict) --

          Specifies the decryption settings for an SRT caller input, including the encryption key configuration and associated parameters.

          • EncryptionKey (dict) -- [REQUIRED]

            Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

            • SecretArn (string) -- [REQUIRED]

              The ARN of the Secrets Manager secret used for transit encryption.

            • RoleArn (string) -- [REQUIRED]

              The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

      • Rtp (dict) --

        The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

        • Port (integer) -- [REQUIRED]

          The port number used for the RTP protocol in the router input configuration.

        • ForwardErrorCorrection (string) --

          The state of forward error correction for the RTP protocol in the router input configuration.

    • Protocol (string) --

      The protocol used by the standard router input.

  • MediaLiveChannel (dict) --

    Configuration settings for connecting a router input to a MediaLive channel output.

    • MediaLiveChannelArn (string) --

      The ARN of the MediaLive channel to connect to this router input.

    • MediaLivePipelineId (string) --

      The index of the MediaLive pipeline to connect to this router input.

    • MediaLiveChannelOutputName (string) --

      The name of the MediaLive channel output to connect to this router input.

    • SourceTransitDecryption (dict) -- [REQUIRED]

      The encryption configuration that defines how content is encrypted during transit between MediaConnect Router and MediaLive. This configuration determines whether encryption keys are automatically managed by the service or manually managed through Secrets Manager.

      • EncryptionKeyType (string) --

        The type of encryption key to use for MediaLive transit encryption.

      • EncryptionKeyConfiguration (dict) -- [REQUIRED]

        The configuration details for the MediaLive encryption key.

        • SecretsManager (dict) --

          The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

          • SecretArn (string) -- [REQUIRED]

            The ARN of the Secrets Manager secret used for transit encryption.

          • RoleArn (string) -- [REQUIRED]

            The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

        • Automatic (dict) --

          Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

  • Failover (dict) --

    Configuration settings for a failover router input that allows switching between two input sources.

    • NetworkInterfaceArn (string) -- [REQUIRED]

      The ARN of the network interface to use for this failover router input.

    • ProtocolConfigurations (list) -- [REQUIRED]

      A list of exactly two protocol configurations for the failover input sources. Both must use the same protocol type.

      • (dict) --

        Protocol configuration settings for failover router inputs.

        • Rist (dict) --

          The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

          • Port (integer) -- [REQUIRED]

            The port number used for the RIST protocol in the router input configuration.

          • RecoveryLatencyMilliseconds (integer) -- [REQUIRED]

            The recovery latency in milliseconds for the RIST protocol in the router input configuration.

        • SrtListener (dict) --

          The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in listener mode, including the port, minimum latency, and decryption key configuration.

          • Port (integer) -- [REQUIRED]

            The port number for the SRT protocol in listener mode.

          • MinimumLatencyMilliseconds (integer) -- [REQUIRED]

            The minimum latency in milliseconds for the SRT protocol in listener mode.

          • DecryptionConfiguration (dict) --

            Specifies the decryption settings for an SRT listener input, including the encryption key configuration and associated parameters.

            • EncryptionKey (dict) -- [REQUIRED]

              Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

              • SecretArn (string) -- [REQUIRED]

                The ARN of the Secrets Manager secret used for transit encryption.

              • RoleArn (string) -- [REQUIRED]

                The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

        • SrtCaller (dict) --

          The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in caller mode, including the source address and port, minimum latency, stream ID, and decryption key configuration.

          • SourceAddress (string) -- [REQUIRED]

            The source IP address for the SRT protocol in caller mode.

          • SourcePort (integer) -- [REQUIRED]

            The source port number for the SRT protocol in caller mode.

          • MinimumLatencyMilliseconds (integer) -- [REQUIRED]

            The minimum latency in milliseconds for the SRT protocol in caller mode.

          • StreamId (string) --

            The stream ID for the SRT protocol in caller mode.

          • DecryptionConfiguration (dict) --

            Specifies the decryption settings for an SRT caller input, including the encryption key configuration and associated parameters.

            • EncryptionKey (dict) -- [REQUIRED]

              Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

              • SecretArn (string) -- [REQUIRED]

                The ARN of the Secrets Manager secret used for transit encryption.

              • RoleArn (string) -- [REQUIRED]

                The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

        • Rtp (dict) --

          The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

          • Port (integer) -- [REQUIRED]

            The port number used for the RTP protocol in the router input configuration.

          • ForwardErrorCorrection (string) --

            The state of forward error correction for the RTP protocol in the router input configuration.

    • SourcePriorityMode (string) -- [REQUIRED]

      The mode for determining source priority in failover configurations.

    • PrimarySourceIndex (integer) --

      The index (0 or 1) that specifies which source in the protocol configurations list is currently active. Used to control which of the two failover sources is currently selected. This field is ignored when sourcePriorityMode is set to NO_PRIORITY

  • MediaConnectFlow (dict) --

    Configuration settings for connecting a router input to a flow output.

    • FlowArn (string) --

      The ARN of the flow to connect to.

    • FlowOutputArn (string) --

      The ARN of the flow output to connect to this router input.

    • SourceTransitDecryption (dict) -- [REQUIRED]

      The decryption configuration for the flow source when connected to this router input.

      • EncryptionKeyType (string) --

        The type of encryption key to use for flow transit encryption.

      • EncryptionKeyConfiguration (dict) -- [REQUIRED]

        The configuration details for the encryption key.

        • SecretsManager (dict) --

          The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

          • SecretArn (string) -- [REQUIRED]

            The ARN of the Secrets Manager secret used for transit encryption.

          • RoleArn (string) -- [REQUIRED]

            The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

        • Automatic (dict) --

          Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

  • Merge (dict) --

    Configuration settings for a merge router input that combines two input sources.

    • NetworkInterfaceArn (string) -- [REQUIRED]

      The ARN of the network interface to use for this merge router input.

    • ProtocolConfigurations (list) -- [REQUIRED]

      A list of exactly two protocol configurations for the merge input sources. Both must use the same protocol type.

      • (dict) --

        Protocol configuration settings for merge router inputs.

        • Rtp (dict) --

          The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

          • Port (integer) -- [REQUIRED]

            The port number used for the RTP protocol in the router input configuration.

          • ForwardErrorCorrection (string) --

            The state of forward error correction for the RTP protocol in the router input configuration.

        • Rist (dict) --

          The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

          • Port (integer) -- [REQUIRED]

            The port number used for the RIST protocol in the router input configuration.

          • RecoveryLatencyMilliseconds (integer) -- [REQUIRED]

            The recovery latency in milliseconds for the RIST protocol in the router input configuration.

    • MergeRecoveryWindowMilliseconds (integer) -- [REQUIRED]

      The time window in milliseconds for merging the two input sources.

type MaximumBitrate:

integer

param MaximumBitrate:

[REQUIRED]

The maximum bitrate for the router input.

type RoutingScope:

string

param RoutingScope:

[REQUIRED]

Specifies whether the router input can be assigned to outputs in different Regions. REGIONAL (default) - connects only to outputs in same Region. GLOBAL - connects to outputs in any Region.

type Tier:

string

param Tier:

[REQUIRED]

The tier level for the router input.

type RegionName:

string

param RegionName:

The Amazon Web Services Region for the router input. Defaults to the current region if not specified.

type AvailabilityZone:

string

param AvailabilityZone:

The Availability Zone where you want to create the router input. This must be a valid Availability Zone for the region specified by regionName, or the current region if no regionName is provided.

type TransitEncryption:

dict

param TransitEncryption:

The transit encryption settings for the router input.

  • EncryptionKeyType (string) --

    Specifies the type of encryption key to use for transit encryption.

  • EncryptionKeyConfiguration (dict) -- [REQUIRED]

    Contains the configuration details for the encryption key used in transit encryption, including the key source and associated parameters.

    • SecretsManager (dict) --

      The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

      • SecretArn (string) -- [REQUIRED]

        The ARN of the Secrets Manager secret used for transit encryption.

      • RoleArn (string) -- [REQUIRED]

        The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

    • Automatic (dict) --

      Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

type MaintenanceConfiguration:

dict

param MaintenanceConfiguration:

The maintenance configuration settings for the router input, including preferred maintenance windows and schedules.

  • PreferredDayTime (dict) --

    Preferred day and time maintenance configuration settings.

    • Day (string) -- [REQUIRED]

      The preferred day for maintenance operations.

    • Time (string) -- [REQUIRED]

      The preferred time for maintenance operations.

  • Default (dict) --

    Default maintenance configuration settings.

type Tags:

dict

param Tags:

Key-value pairs that can be used to tag and organize this router input.

  • (string) --

    • (string) --

type ClientToken:

string

param ClientToken:

A unique identifier for the request to ensure idempotency.

This field is autopopulated if not provided.

rtype:

dict

returns:

Response Syntax

{
    'RouterInput': {
        'Name': 'string',
        'Arn': 'string',
        'Id': 'string',
        'State': 'CREATING'|'STANDBY'|'STARTING'|'ACTIVE'|'STOPPING'|'DELETING'|'UPDATING'|'ERROR'|'RECOVERING'|'MIGRATING',
        'InputType': 'STANDARD'|'FAILOVER'|'MERGE'|'MEDIACONNECT_FLOW'|'MEDIALIVE_CHANNEL',
        'Configuration': {
            'Standard': {
                'NetworkInterfaceArn': 'string',
                'ProtocolConfiguration': {
                    'Rist': {
                        'Port': 123,
                        'RecoveryLatencyMilliseconds': 123
                    },
                    'SrtListener': {
                        'Port': 123,
                        'MinimumLatencyMilliseconds': 123,
                        'DecryptionConfiguration': {
                            'EncryptionKey': {
                                'SecretArn': 'string',
                                'RoleArn': 'string'
                            }
                        }
                    },
                    'SrtCaller': {
                        'SourceAddress': 'string',
                        'SourcePort': 123,
                        'MinimumLatencyMilliseconds': 123,
                        'StreamId': 'string',
                        'DecryptionConfiguration': {
                            'EncryptionKey': {
                                'SecretArn': 'string',
                                'RoleArn': 'string'
                            }
                        }
                    },
                    'Rtp': {
                        'Port': 123,
                        'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                    }
                },
                'Protocol': 'RTP'|'RIST'|'SRT_CALLER'|'SRT_LISTENER'
            },
            'MediaLiveChannel': {
                'MediaLiveChannelArn': 'string',
                'MediaLivePipelineId': 'PIPELINE_0'|'PIPELINE_1',
                'MediaLiveChannelOutputName': 'string',
                'SourceTransitDecryption': {
                    'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
                    'EncryptionKeyConfiguration': {
                        'SecretsManager': {
                            'SecretArn': 'string',
                            'RoleArn': 'string'
                        },
                        'Automatic': {}
                    }
                }
            },
            'Failover': {
                'NetworkInterfaceArn': 'string',
                'ProtocolConfigurations': [
                    {
                        'Rist': {
                            'Port': 123,
                            'RecoveryLatencyMilliseconds': 123
                        },
                        'SrtListener': {
                            'Port': 123,
                            'MinimumLatencyMilliseconds': 123,
                            'DecryptionConfiguration': {
                                'EncryptionKey': {
                                    'SecretArn': 'string',
                                    'RoleArn': 'string'
                                }
                            }
                        },
                        'SrtCaller': {
                            'SourceAddress': 'string',
                            'SourcePort': 123,
                            'MinimumLatencyMilliseconds': 123,
                            'StreamId': 'string',
                            'DecryptionConfiguration': {
                                'EncryptionKey': {
                                    'SecretArn': 'string',
                                    'RoleArn': 'string'
                                }
                            }
                        },
                        'Rtp': {
                            'Port': 123,
                            'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                        }
                    },
                ],
                'SourcePriorityMode': 'NO_PRIORITY'|'PRIMARY_SECONDARY',
                'PrimarySourceIndex': 123
            },
            'MediaConnectFlow': {
                'FlowArn': 'string',
                'FlowOutputArn': 'string',
                'SourceTransitDecryption': {
                    'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
                    'EncryptionKeyConfiguration': {
                        'SecretsManager': {
                            'SecretArn': 'string',
                            'RoleArn': 'string'
                        },
                        'Automatic': {}
                    }
                }
            },
            'Merge': {
                'NetworkInterfaceArn': 'string',
                'ProtocolConfigurations': [
                    {
                        'Rtp': {
                            'Port': 123,
                            'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                        },
                        'Rist': {
                            'Port': 123,
                            'RecoveryLatencyMilliseconds': 123
                        }
                    },
                ],
                'MergeRecoveryWindowMilliseconds': 123
            }
        },
        'RoutedOutputs': 123,
        'MaximumRoutedOutputs': 123,
        'RegionName': 'string',
        'AvailabilityZone': 'string',
        'MaximumBitrate': 123,
        'Tier': 'INPUT_100'|'INPUT_50'|'INPUT_20',
        'RoutingScope': 'REGIONAL'|'GLOBAL',
        'CreatedAt': datetime(2015, 1, 1),
        'UpdatedAt': datetime(2015, 1, 1),
        'Messages': [
            {
                'Code': 'string',
                'Message': 'string'
            },
        ],
        'TransitEncryption': {
            'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
            'EncryptionKeyConfiguration': {
                'SecretsManager': {
                    'SecretArn': 'string',
                    'RoleArn': 'string'
                },
                'Automatic': {}
            }
        },
        'Tags': {
            'string': 'string'
        },
        'StreamDetails': {
            'Standard': {
                'SourceIpAddress': 'string'
            },
            'MediaLiveChannel': {},
            'Failover': {
                'SourceIndexZeroStreamDetails': {
                    'SourceIndex': 123,
                    'SourceIpAddress': 'string'
                },
                'SourceIndexOneStreamDetails': {
                    'SourceIndex': 123,
                    'SourceIpAddress': 'string'
                }
            },
            'MediaConnectFlow': {},
            'Merge': {
                'SourceIndexZeroStreamDetails': {
                    'SourceIndex': 123,
                    'SourceIpAddress': 'string'
                },
                'SourceIndexOneStreamDetails': {
                    'SourceIndex': 123,
                    'SourceIpAddress': 'string'
                }
            }
        },
        'IpAddress': 'string',
        'MaintenanceType': 'PREFERRED_DAY_TIME'|'DEFAULT',
        'MaintenanceConfiguration': {
            'PreferredDayTime': {
                'Day': 'MONDAY'|'TUESDAY'|'WEDNESDAY'|'THURSDAY'|'FRIDAY'|'SATURDAY'|'SUNDAY',
                'Time': 'string'
            },
            'Default': {}
        },
        'MaintenanceScheduleType': 'WINDOW',
        'MaintenanceSchedule': {
            'Window': {
                'Start': datetime(2015, 1, 1),
                'End': datetime(2015, 1, 1),
                'ScheduledTime': datetime(2015, 1, 1)
            }
        }
    }
}

Response Structure

  • (dict) --

    • RouterInput (dict) --

      The newly-created router input.

      • Name (string) --

        The name of the router input.

      • Arn (string) --

        The Amazon Resource Name (ARN) of the router input.

      • Id (string) --

        The unique identifier of the router input.

      • State (string) --

        The current state of the router input.

      • InputType (string) --

        The type of the router input.

      • Configuration (dict) --

        The configuration settings for a router input.

        • Standard (dict) --

          The configuration settings for a standard router input, including the protocol, protocol-specific configuration, network interface, and availability zone.

          • NetworkInterfaceArn (string) --

            The Amazon Resource Name (ARN) of the network interface associated with the standard router input.

          • ProtocolConfiguration (dict) --

            The configuration settings for the protocol used by the standard router input.

            • Rist (dict) --

              The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

              • Port (integer) --

                The port number used for the RIST protocol in the router input configuration.

              • RecoveryLatencyMilliseconds (integer) --

                The recovery latency in milliseconds for the RIST protocol in the router input configuration.

            • SrtListener (dict) --

              The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in listener mode, including the port, minimum latency, and decryption key configuration.

              • Port (integer) --

                The port number for the SRT protocol in listener mode.

              • MinimumLatencyMilliseconds (integer) --

                The minimum latency in milliseconds for the SRT protocol in listener mode.

              • DecryptionConfiguration (dict) --

                Specifies the decryption settings for an SRT listener input, including the encryption key configuration and associated parameters.

                • EncryptionKey (dict) --

                  Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                  • SecretArn (string) --

                    The ARN of the Secrets Manager secret used for transit encryption.

                  • RoleArn (string) --

                    The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

            • SrtCaller (dict) --

              The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in caller mode, including the source address and port, minimum latency, stream ID, and decryption key configuration.

              • SourceAddress (string) --

                The source IP address for the SRT protocol in caller mode.

              • SourcePort (integer) --

                The source port number for the SRT protocol in caller mode.

              • MinimumLatencyMilliseconds (integer) --

                The minimum latency in milliseconds for the SRT protocol in caller mode.

              • StreamId (string) --

                The stream ID for the SRT protocol in caller mode.

              • DecryptionConfiguration (dict) --

                Specifies the decryption settings for an SRT caller input, including the encryption key configuration and associated parameters.

                • EncryptionKey (dict) --

                  Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                  • SecretArn (string) --

                    The ARN of the Secrets Manager secret used for transit encryption.

                  • RoleArn (string) --

                    The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

            • Rtp (dict) --

              The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

              • Port (integer) --

                The port number used for the RTP protocol in the router input configuration.

              • ForwardErrorCorrection (string) --

                The state of forward error correction for the RTP protocol in the router input configuration.

          • Protocol (string) --

            The protocol used by the standard router input.

        • MediaLiveChannel (dict) --

          Configuration settings for connecting a router input to a MediaLive channel output.

          • MediaLiveChannelArn (string) --

            The ARN of the MediaLive channel to connect to this router input.

          • MediaLivePipelineId (string) --

            The index of the MediaLive pipeline to connect to this router input.

          • MediaLiveChannelOutputName (string) --

            The name of the MediaLive channel output to connect to this router input.

          • SourceTransitDecryption (dict) --

            The encryption configuration that defines how content is encrypted during transit between MediaConnect Router and MediaLive. This configuration determines whether encryption keys are automatically managed by the service or manually managed through Secrets Manager.

            • EncryptionKeyType (string) --

              The type of encryption key to use for MediaLive transit encryption.

            • EncryptionKeyConfiguration (dict) --

              The configuration details for the MediaLive encryption key.

              • SecretsManager (dict) --

                The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

                • SecretArn (string) --

                  The ARN of the Secrets Manager secret used for transit encryption.

                • RoleArn (string) --

                  The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • Automatic (dict) --

                Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

        • Failover (dict) --

          Configuration settings for a failover router input that allows switching between two input sources.

          • NetworkInterfaceArn (string) --

            The ARN of the network interface to use for this failover router input.

          • ProtocolConfigurations (list) --

            A list of exactly two protocol configurations for the failover input sources. Both must use the same protocol type.

            • (dict) --

              Protocol configuration settings for failover router inputs.

              • Rist (dict) --

                The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

                • Port (integer) --

                  The port number used for the RIST protocol in the router input configuration.

                • RecoveryLatencyMilliseconds (integer) --

                  The recovery latency in milliseconds for the RIST protocol in the router input configuration.

              • SrtListener (dict) --

                The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in listener mode, including the port, minimum latency, and decryption key configuration.

                • Port (integer) --

                  The port number for the SRT protocol in listener mode.

                • MinimumLatencyMilliseconds (integer) --

                  The minimum latency in milliseconds for the SRT protocol in listener mode.

                • DecryptionConfiguration (dict) --

                  Specifies the decryption settings for an SRT listener input, including the encryption key configuration and associated parameters.

                  • EncryptionKey (dict) --

                    Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                    • SecretArn (string) --

                      The ARN of the Secrets Manager secret used for transit encryption.

                    • RoleArn (string) --

                      The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • SrtCaller (dict) --

                The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in caller mode, including the source address and port, minimum latency, stream ID, and decryption key configuration.

                • SourceAddress (string) --

                  The source IP address for the SRT protocol in caller mode.

                • SourcePort (integer) --

                  The source port number for the SRT protocol in caller mode.

                • MinimumLatencyMilliseconds (integer) --

                  The minimum latency in milliseconds for the SRT protocol in caller mode.

                • StreamId (string) --

                  The stream ID for the SRT protocol in caller mode.

                • DecryptionConfiguration (dict) --

                  Specifies the decryption settings for an SRT caller input, including the encryption key configuration and associated parameters.

                  • EncryptionKey (dict) --

                    Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                    • SecretArn (string) --

                      The ARN of the Secrets Manager secret used for transit encryption.

                    • RoleArn (string) --

                      The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • Rtp (dict) --

                The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

                • Port (integer) --

                  The port number used for the RTP protocol in the router input configuration.

                • ForwardErrorCorrection (string) --

                  The state of forward error correction for the RTP protocol in the router input configuration.

          • SourcePriorityMode (string) --

            The mode for determining source priority in failover configurations.

          • PrimarySourceIndex (integer) --

            The index (0 or 1) that specifies which source in the protocol configurations list is currently active. Used to control which of the two failover sources is currently selected. This field is ignored when sourcePriorityMode is set to NO_PRIORITY

        • MediaConnectFlow (dict) --

          Configuration settings for connecting a router input to a flow output.

          • FlowArn (string) --

            The ARN of the flow to connect to.

          • FlowOutputArn (string) --

            The ARN of the flow output to connect to this router input.

          • SourceTransitDecryption (dict) --

            The decryption configuration for the flow source when connected to this router input.

            • EncryptionKeyType (string) --

              The type of encryption key to use for flow transit encryption.

            • EncryptionKeyConfiguration (dict) --

              The configuration details for the encryption key.

              • SecretsManager (dict) --

                The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

                • SecretArn (string) --

                  The ARN of the Secrets Manager secret used for transit encryption.

                • RoleArn (string) --

                  The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • Automatic (dict) --

                Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

        • Merge (dict) --

          Configuration settings for a merge router input that combines two input sources.

          • NetworkInterfaceArn (string) --

            The ARN of the network interface to use for this merge router input.

          • ProtocolConfigurations (list) --

            A list of exactly two protocol configurations for the merge input sources. Both must use the same protocol type.

            • (dict) --

              Protocol configuration settings for merge router inputs.

              • Rtp (dict) --

                The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

                • Port (integer) --

                  The port number used for the RTP protocol in the router input configuration.

                • ForwardErrorCorrection (string) --

                  The state of forward error correction for the RTP protocol in the router input configuration.

              • Rist (dict) --

                The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

                • Port (integer) --

                  The port number used for the RIST protocol in the router input configuration.

                • RecoveryLatencyMilliseconds (integer) --

                  The recovery latency in milliseconds for the RIST protocol in the router input configuration.

          • MergeRecoveryWindowMilliseconds (integer) --

            The time window in milliseconds for merging the two input sources.

      • RoutedOutputs (integer) --

        The number of router outputs associated with the router input.

      • MaximumRoutedOutputs (integer) --

        The maximum number of outputs that can be simultaneously routed to this input.

      • RegionName (string) --

        The Amazon Web Services Region where the router input is located.

      • AvailabilityZone (string) --

        The Availability Zone of the router input.

      • MaximumBitrate (integer) --

        The maximum bitrate for the router input.

      • Tier (string) --

        The tier level of the router input.

      • RoutingScope (string) --

        Indicates whether the router input is configured for Regional or global routing.

      • CreatedAt (datetime) --

        The timestamp when the router input was created.

      • UpdatedAt (datetime) --

        The timestamp when the router input was last updated.

      • Messages (list) --

        The messages associated with the router input.

        • (dict) --

          A message associated with a router input, including a code and a message.

          • Code (string) --

            The code associated with the router input message.

          • Message (string) --

            The message text associated with the router input message.

      • TransitEncryption (dict) --

        The transit encryption settings for a router input.

        • EncryptionKeyType (string) --

          Specifies the type of encryption key to use for transit encryption.

        • EncryptionKeyConfiguration (dict) --

          Contains the configuration details for the encryption key used in transit encryption, including the key source and associated parameters.

          • SecretsManager (dict) --

            The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

            • SecretArn (string) --

              The ARN of the Secrets Manager secret used for transit encryption.

            • RoleArn (string) --

              The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

          • Automatic (dict) --

            Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

      • Tags (dict) --

        Key-value pairs that can be used to tag and organize this router input.

        • (string) --

          • (string) --

      • StreamDetails (dict) --

        Configuration details for the router input stream.

        • Standard (dict) --

          Configuration details for a standard router input stream type.

          • SourceIpAddress (string) --

            The source IP address for the standard router input stream.

        • MediaLiveChannel (dict) --

          Configuration details for a MediaLive channel when used as a router input source.

        • Failover (dict) --

          Configuration details for a failover router input that can automatically switch between two sources.

          • SourceIndexZeroStreamDetails (dict) --

            Configuration details for the primary source (index 0) in the failover setup.

            • SourceIndex (integer) --

              The index number (0 or 1) assigned to this source in the failover configuration.

            • SourceIpAddress (string) --

              The IP address of the source for this indexed stream.

          • SourceIndexOneStreamDetails (dict) --

            Configuration details for the secondary source (index 1) in the failover setup.

            • SourceIndex (integer) --

              The index number (0 or 1) assigned to this source in the failover configuration.

            • SourceIpAddress (string) --

              The IP address of the source for this indexed stream.

        • MediaConnectFlow (dict) --

          Configuration details for a MediaConnect flow when used as a router input source.

        • Merge (dict) --

          Configuration details for a merge router input that combines two input sources.

          • SourceIndexZeroStreamDetails (dict) --

            Configuration details for the first source (index 0) in the merge setup.

            • SourceIndex (integer) --

              The index number (0 or 1) assigned to this source in the merge configuration.

            • SourceIpAddress (string) --

              The IP address of the source for this indexed stream in the merge setup.

          • SourceIndexOneStreamDetails (dict) --

            Configuration details for the second source (index 1) in the merge setup.

            • SourceIndex (integer) --

              The index number (0 or 1) assigned to this source in the merge configuration.

            • SourceIpAddress (string) --

              The IP address of the source for this indexed stream in the merge setup.

      • IpAddress (string) --

        The IP address of the router input.

      • MaintenanceType (string) --

        The type of maintenance configuration applied to this router input.

      • MaintenanceConfiguration (dict) --

        The maintenance configuration settings applied to this router input.

        • PreferredDayTime (dict) --

          Preferred day and time maintenance configuration settings.

          • Day (string) --

            The preferred day for maintenance operations.

          • Time (string) --

            The preferred time for maintenance operations.

        • Default (dict) --

          Default maintenance configuration settings.

      • MaintenanceScheduleType (string) --

        The type of maintenance schedule currently in effect for this router input.

      • MaintenanceSchedule (dict) --

        The current maintenance schedule details for this router input.

        • Window (dict) --

          Defines a specific time window for maintenance operations.

          • Start (datetime) --

            The start time of the maintenance window.

          • End (datetime) --

            The end time of the maintenance window.

          • ScheduledTime (datetime) --

            The date and time when the maintenance window is scheduled to occur.

GetRouterInput (updated) Link ¶
Changes (response)
{'RouterInput': {'Configuration': {'MediaLiveChannel': {'MediaLiveChannelArn': 'string',
                                                        'MediaLiveChannelOutputName': 'string',
                                                        'MediaLivePipelineId': 'PIPELINE_0 '
                                                                               '| '
                                                                               'PIPELINE_1',
                                                        'SourceTransitDecryption': {'EncryptionKeyConfiguration': {'Automatic': {},
                                                                                                                   'SecretsManager': {'RoleArn': 'string',
                                                                                                                                      'SecretArn': 'string'}},
                                                                                    'EncryptionKeyType': 'SECRETS_MANAGER '
                                                                                                         '| '
                                                                                                         'AUTOMATIC'}}},
                 'InputType': {'MEDIALIVE_CHANNEL'},
                 'StreamDetails': {'MediaLiveChannel': {}}}}

Retrieves information about a specific router input in AWS Elemental MediaConnect.

See also: AWS API Documentation

Request Syntax

client.get_router_input(
    Arn='string'
)
type Arn:

string

param Arn:

[REQUIRED]

The Amazon Resource Name (ARN) of the router input to retrieve information about.

rtype:

dict

returns:

Response Syntax

{
    'RouterInput': {
        'Name': 'string',
        'Arn': 'string',
        'Id': 'string',
        'State': 'CREATING'|'STANDBY'|'STARTING'|'ACTIVE'|'STOPPING'|'DELETING'|'UPDATING'|'ERROR'|'RECOVERING'|'MIGRATING',
        'InputType': 'STANDARD'|'FAILOVER'|'MERGE'|'MEDIACONNECT_FLOW'|'MEDIALIVE_CHANNEL',
        'Configuration': {
            'Standard': {
                'NetworkInterfaceArn': 'string',
                'ProtocolConfiguration': {
                    'Rist': {
                        'Port': 123,
                        'RecoveryLatencyMilliseconds': 123
                    },
                    'SrtListener': {
                        'Port': 123,
                        'MinimumLatencyMilliseconds': 123,
                        'DecryptionConfiguration': {
                            'EncryptionKey': {
                                'SecretArn': 'string',
                                'RoleArn': 'string'
                            }
                        }
                    },
                    'SrtCaller': {
                        'SourceAddress': 'string',
                        'SourcePort': 123,
                        'MinimumLatencyMilliseconds': 123,
                        'StreamId': 'string',
                        'DecryptionConfiguration': {
                            'EncryptionKey': {
                                'SecretArn': 'string',
                                'RoleArn': 'string'
                            }
                        }
                    },
                    'Rtp': {
                        'Port': 123,
                        'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                    }
                },
                'Protocol': 'RTP'|'RIST'|'SRT_CALLER'|'SRT_LISTENER'
            },
            'MediaLiveChannel': {
                'MediaLiveChannelArn': 'string',
                'MediaLivePipelineId': 'PIPELINE_0'|'PIPELINE_1',
                'MediaLiveChannelOutputName': 'string',
                'SourceTransitDecryption': {
                    'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
                    'EncryptionKeyConfiguration': {
                        'SecretsManager': {
                            'SecretArn': 'string',
                            'RoleArn': 'string'
                        },
                        'Automatic': {}
                    }
                }
            },
            'Failover': {
                'NetworkInterfaceArn': 'string',
                'ProtocolConfigurations': [
                    {
                        'Rist': {
                            'Port': 123,
                            'RecoveryLatencyMilliseconds': 123
                        },
                        'SrtListener': {
                            'Port': 123,
                            'MinimumLatencyMilliseconds': 123,
                            'DecryptionConfiguration': {
                                'EncryptionKey': {
                                    'SecretArn': 'string',
                                    'RoleArn': 'string'
                                }
                            }
                        },
                        'SrtCaller': {
                            'SourceAddress': 'string',
                            'SourcePort': 123,
                            'MinimumLatencyMilliseconds': 123,
                            'StreamId': 'string',
                            'DecryptionConfiguration': {
                                'EncryptionKey': {
                                    'SecretArn': 'string',
                                    'RoleArn': 'string'
                                }
                            }
                        },
                        'Rtp': {
                            'Port': 123,
                            'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                        }
                    },
                ],
                'SourcePriorityMode': 'NO_PRIORITY'|'PRIMARY_SECONDARY',
                'PrimarySourceIndex': 123
            },
            'MediaConnectFlow': {
                'FlowArn': 'string',
                'FlowOutputArn': 'string',
                'SourceTransitDecryption': {
                    'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
                    'EncryptionKeyConfiguration': {
                        'SecretsManager': {
                            'SecretArn': 'string',
                            'RoleArn': 'string'
                        },
                        'Automatic': {}
                    }
                }
            },
            'Merge': {
                'NetworkInterfaceArn': 'string',
                'ProtocolConfigurations': [
                    {
                        'Rtp': {
                            'Port': 123,
                            'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                        },
                        'Rist': {
                            'Port': 123,
                            'RecoveryLatencyMilliseconds': 123
                        }
                    },
                ],
                'MergeRecoveryWindowMilliseconds': 123
            }
        },
        'RoutedOutputs': 123,
        'MaximumRoutedOutputs': 123,
        'RegionName': 'string',
        'AvailabilityZone': 'string',
        'MaximumBitrate': 123,
        'Tier': 'INPUT_100'|'INPUT_50'|'INPUT_20',
        'RoutingScope': 'REGIONAL'|'GLOBAL',
        'CreatedAt': datetime(2015, 1, 1),
        'UpdatedAt': datetime(2015, 1, 1),
        'Messages': [
            {
                'Code': 'string',
                'Message': 'string'
            },
        ],
        'TransitEncryption': {
            'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
            'EncryptionKeyConfiguration': {
                'SecretsManager': {
                    'SecretArn': 'string',
                    'RoleArn': 'string'
                },
                'Automatic': {}
            }
        },
        'Tags': {
            'string': 'string'
        },
        'StreamDetails': {
            'Standard': {
                'SourceIpAddress': 'string'
            },
            'MediaLiveChannel': {},
            'Failover': {
                'SourceIndexZeroStreamDetails': {
                    'SourceIndex': 123,
                    'SourceIpAddress': 'string'
                },
                'SourceIndexOneStreamDetails': {
                    'SourceIndex': 123,
                    'SourceIpAddress': 'string'
                }
            },
            'MediaConnectFlow': {},
            'Merge': {
                'SourceIndexZeroStreamDetails': {
                    'SourceIndex': 123,
                    'SourceIpAddress': 'string'
                },
                'SourceIndexOneStreamDetails': {
                    'SourceIndex': 123,
                    'SourceIpAddress': 'string'
                }
            }
        },
        'IpAddress': 'string',
        'MaintenanceType': 'PREFERRED_DAY_TIME'|'DEFAULT',
        'MaintenanceConfiguration': {
            'PreferredDayTime': {
                'Day': 'MONDAY'|'TUESDAY'|'WEDNESDAY'|'THURSDAY'|'FRIDAY'|'SATURDAY'|'SUNDAY',
                'Time': 'string'
            },
            'Default': {}
        },
        'MaintenanceScheduleType': 'WINDOW',
        'MaintenanceSchedule': {
            'Window': {
                'Start': datetime(2015, 1, 1),
                'End': datetime(2015, 1, 1),
                'ScheduledTime': datetime(2015, 1, 1)
            }
        }
    }
}

Response Structure

  • (dict) --

    • RouterInput (dict) --

      The details of the requested router input, including its configuration, state, and other attributes.

      • Name (string) --

        The name of the router input.

      • Arn (string) --

        The Amazon Resource Name (ARN) of the router input.

      • Id (string) --

        The unique identifier of the router input.

      • State (string) --

        The current state of the router input.

      • InputType (string) --

        The type of the router input.

      • Configuration (dict) --

        The configuration settings for a router input.

        • Standard (dict) --

          The configuration settings for a standard router input, including the protocol, protocol-specific configuration, network interface, and availability zone.

          • NetworkInterfaceArn (string) --

            The Amazon Resource Name (ARN) of the network interface associated with the standard router input.

          • ProtocolConfiguration (dict) --

            The configuration settings for the protocol used by the standard router input.

            • Rist (dict) --

              The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

              • Port (integer) --

                The port number used for the RIST protocol in the router input configuration.

              • RecoveryLatencyMilliseconds (integer) --

                The recovery latency in milliseconds for the RIST protocol in the router input configuration.

            • SrtListener (dict) --

              The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in listener mode, including the port, minimum latency, and decryption key configuration.

              • Port (integer) --

                The port number for the SRT protocol in listener mode.

              • MinimumLatencyMilliseconds (integer) --

                The minimum latency in milliseconds for the SRT protocol in listener mode.

              • DecryptionConfiguration (dict) --

                Specifies the decryption settings for an SRT listener input, including the encryption key configuration and associated parameters.

                • EncryptionKey (dict) --

                  Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                  • SecretArn (string) --

                    The ARN of the Secrets Manager secret used for transit encryption.

                  • RoleArn (string) --

                    The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

            • SrtCaller (dict) --

              The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in caller mode, including the source address and port, minimum latency, stream ID, and decryption key configuration.

              • SourceAddress (string) --

                The source IP address for the SRT protocol in caller mode.

              • SourcePort (integer) --

                The source port number for the SRT protocol in caller mode.

              • MinimumLatencyMilliseconds (integer) --

                The minimum latency in milliseconds for the SRT protocol in caller mode.

              • StreamId (string) --

                The stream ID for the SRT protocol in caller mode.

              • DecryptionConfiguration (dict) --

                Specifies the decryption settings for an SRT caller input, including the encryption key configuration and associated parameters.

                • EncryptionKey (dict) --

                  Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                  • SecretArn (string) --

                    The ARN of the Secrets Manager secret used for transit encryption.

                  • RoleArn (string) --

                    The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

            • Rtp (dict) --

              The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

              • Port (integer) --

                The port number used for the RTP protocol in the router input configuration.

              • ForwardErrorCorrection (string) --

                The state of forward error correction for the RTP protocol in the router input configuration.

          • Protocol (string) --

            The protocol used by the standard router input.

        • MediaLiveChannel (dict) --

          Configuration settings for connecting a router input to a MediaLive channel output.

          • MediaLiveChannelArn (string) --

            The ARN of the MediaLive channel to connect to this router input.

          • MediaLivePipelineId (string) --

            The index of the MediaLive pipeline to connect to this router input.

          • MediaLiveChannelOutputName (string) --

            The name of the MediaLive channel output to connect to this router input.

          • SourceTransitDecryption (dict) --

            The encryption configuration that defines how content is encrypted during transit between MediaConnect Router and MediaLive. This configuration determines whether encryption keys are automatically managed by the service or manually managed through Secrets Manager.

            • EncryptionKeyType (string) --

              The type of encryption key to use for MediaLive transit encryption.

            • EncryptionKeyConfiguration (dict) --

              The configuration details for the MediaLive encryption key.

              • SecretsManager (dict) --

                The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

                • SecretArn (string) --

                  The ARN of the Secrets Manager secret used for transit encryption.

                • RoleArn (string) --

                  The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • Automatic (dict) --

                Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

        • Failover (dict) --

          Configuration settings for a failover router input that allows switching between two input sources.

          • NetworkInterfaceArn (string) --

            The ARN of the network interface to use for this failover router input.

          • ProtocolConfigurations (list) --

            A list of exactly two protocol configurations for the failover input sources. Both must use the same protocol type.

            • (dict) --

              Protocol configuration settings for failover router inputs.

              • Rist (dict) --

                The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

                • Port (integer) --

                  The port number used for the RIST protocol in the router input configuration.

                • RecoveryLatencyMilliseconds (integer) --

                  The recovery latency in milliseconds for the RIST protocol in the router input configuration.

              • SrtListener (dict) --

                The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in listener mode, including the port, minimum latency, and decryption key configuration.

                • Port (integer) --

                  The port number for the SRT protocol in listener mode.

                • MinimumLatencyMilliseconds (integer) --

                  The minimum latency in milliseconds for the SRT protocol in listener mode.

                • DecryptionConfiguration (dict) --

                  Specifies the decryption settings for an SRT listener input, including the encryption key configuration and associated parameters.

                  • EncryptionKey (dict) --

                    Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                    • SecretArn (string) --

                      The ARN of the Secrets Manager secret used for transit encryption.

                    • RoleArn (string) --

                      The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • SrtCaller (dict) --

                The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in caller mode, including the source address and port, minimum latency, stream ID, and decryption key configuration.

                • SourceAddress (string) --

                  The source IP address for the SRT protocol in caller mode.

                • SourcePort (integer) --

                  The source port number for the SRT protocol in caller mode.

                • MinimumLatencyMilliseconds (integer) --

                  The minimum latency in milliseconds for the SRT protocol in caller mode.

                • StreamId (string) --

                  The stream ID for the SRT protocol in caller mode.

                • DecryptionConfiguration (dict) --

                  Specifies the decryption settings for an SRT caller input, including the encryption key configuration and associated parameters.

                  • EncryptionKey (dict) --

                    Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                    • SecretArn (string) --

                      The ARN of the Secrets Manager secret used for transit encryption.

                    • RoleArn (string) --

                      The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • Rtp (dict) --

                The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

                • Port (integer) --

                  The port number used for the RTP protocol in the router input configuration.

                • ForwardErrorCorrection (string) --

                  The state of forward error correction for the RTP protocol in the router input configuration.

          • SourcePriorityMode (string) --

            The mode for determining source priority in failover configurations.

          • PrimarySourceIndex (integer) --

            The index (0 or 1) that specifies which source in the protocol configurations list is currently active. Used to control which of the two failover sources is currently selected. This field is ignored when sourcePriorityMode is set to NO_PRIORITY

        • MediaConnectFlow (dict) --

          Configuration settings for connecting a router input to a flow output.

          • FlowArn (string) --

            The ARN of the flow to connect to.

          • FlowOutputArn (string) --

            The ARN of the flow output to connect to this router input.

          • SourceTransitDecryption (dict) --

            The decryption configuration for the flow source when connected to this router input.

            • EncryptionKeyType (string) --

              The type of encryption key to use for flow transit encryption.

            • EncryptionKeyConfiguration (dict) --

              The configuration details for the encryption key.

              • SecretsManager (dict) --

                The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

                • SecretArn (string) --

                  The ARN of the Secrets Manager secret used for transit encryption.

                • RoleArn (string) --

                  The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • Automatic (dict) --

                Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

        • Merge (dict) --

          Configuration settings for a merge router input that combines two input sources.

          • NetworkInterfaceArn (string) --

            The ARN of the network interface to use for this merge router input.

          • ProtocolConfigurations (list) --

            A list of exactly two protocol configurations for the merge input sources. Both must use the same protocol type.

            • (dict) --

              Protocol configuration settings for merge router inputs.

              • Rtp (dict) --

                The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

                • Port (integer) --

                  The port number used for the RTP protocol in the router input configuration.

                • ForwardErrorCorrection (string) --

                  The state of forward error correction for the RTP protocol in the router input configuration.

              • Rist (dict) --

                The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

                • Port (integer) --

                  The port number used for the RIST protocol in the router input configuration.

                • RecoveryLatencyMilliseconds (integer) --

                  The recovery latency in milliseconds for the RIST protocol in the router input configuration.

          • MergeRecoveryWindowMilliseconds (integer) --

            The time window in milliseconds for merging the two input sources.

      • RoutedOutputs (integer) --

        The number of router outputs associated with the router input.

      • MaximumRoutedOutputs (integer) --

        The maximum number of outputs that can be simultaneously routed to this input.

      • RegionName (string) --

        The Amazon Web Services Region where the router input is located.

      • AvailabilityZone (string) --

        The Availability Zone of the router input.

      • MaximumBitrate (integer) --

        The maximum bitrate for the router input.

      • Tier (string) --

        The tier level of the router input.

      • RoutingScope (string) --

        Indicates whether the router input is configured for Regional or global routing.

      • CreatedAt (datetime) --

        The timestamp when the router input was created.

      • UpdatedAt (datetime) --

        The timestamp when the router input was last updated.

      • Messages (list) --

        The messages associated with the router input.

        • (dict) --

          A message associated with a router input, including a code and a message.

          • Code (string) --

            The code associated with the router input message.

          • Message (string) --

            The message text associated with the router input message.

      • TransitEncryption (dict) --

        The transit encryption settings for a router input.

        • EncryptionKeyType (string) --

          Specifies the type of encryption key to use for transit encryption.

        • EncryptionKeyConfiguration (dict) --

          Contains the configuration details for the encryption key used in transit encryption, including the key source and associated parameters.

          • SecretsManager (dict) --

            The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

            • SecretArn (string) --

              The ARN of the Secrets Manager secret used for transit encryption.

            • RoleArn (string) --

              The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

          • Automatic (dict) --

            Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

      • Tags (dict) --

        Key-value pairs that can be used to tag and organize this router input.

        • (string) --

          • (string) --

      • StreamDetails (dict) --

        Configuration details for the router input stream.

        • Standard (dict) --

          Configuration details for a standard router input stream type.

          • SourceIpAddress (string) --

            The source IP address for the standard router input stream.

        • MediaLiveChannel (dict) --

          Configuration details for a MediaLive channel when used as a router input source.

        • Failover (dict) --

          Configuration details for a failover router input that can automatically switch between two sources.

          • SourceIndexZeroStreamDetails (dict) --

            Configuration details for the primary source (index 0) in the failover setup.

            • SourceIndex (integer) --

              The index number (0 or 1) assigned to this source in the failover configuration.

            • SourceIpAddress (string) --

              The IP address of the source for this indexed stream.

          • SourceIndexOneStreamDetails (dict) --

            Configuration details for the secondary source (index 1) in the failover setup.

            • SourceIndex (integer) --

              The index number (0 or 1) assigned to this source in the failover configuration.

            • SourceIpAddress (string) --

              The IP address of the source for this indexed stream.

        • MediaConnectFlow (dict) --

          Configuration details for a MediaConnect flow when used as a router input source.

        • Merge (dict) --

          Configuration details for a merge router input that combines two input sources.

          • SourceIndexZeroStreamDetails (dict) --

            Configuration details for the first source (index 0) in the merge setup.

            • SourceIndex (integer) --

              The index number (0 or 1) assigned to this source in the merge configuration.

            • SourceIpAddress (string) --

              The IP address of the source for this indexed stream in the merge setup.

          • SourceIndexOneStreamDetails (dict) --

            Configuration details for the second source (index 1) in the merge setup.

            • SourceIndex (integer) --

              The index number (0 or 1) assigned to this source in the merge configuration.

            • SourceIpAddress (string) --

              The IP address of the source for this indexed stream in the merge setup.

      • IpAddress (string) --

        The IP address of the router input.

      • MaintenanceType (string) --

        The type of maintenance configuration applied to this router input.

      • MaintenanceConfiguration (dict) --

        The maintenance configuration settings applied to this router input.

        • PreferredDayTime (dict) --

          Preferred day and time maintenance configuration settings.

          • Day (string) --

            The preferred day for maintenance operations.

          • Time (string) --

            The preferred time for maintenance operations.

        • Default (dict) --

          Default maintenance configuration settings.

      • MaintenanceScheduleType (string) --

        The type of maintenance schedule currently in effect for this router input.

      • MaintenanceSchedule (dict) --

        The current maintenance schedule details for this router input.

        • Window (dict) --

          Defines a specific time window for maintenance operations.

          • Start (datetime) --

            The start time of the maintenance window.

          • End (datetime) --

            The end time of the maintenance window.

          • ScheduledTime (datetime) --

            The date and time when the maintenance window is scheduled to occur.

ListRouterInputs (updated) Link ¶
Changes (request, response)
Request
{'Filters': {'InputTypes': {'MEDIALIVE_CHANNEL'}}}
Response
{'RouterInputs': {'InputType': {'MEDIALIVE_CHANNEL'}}}

Retrieves a list of router inputs in AWS Elemental MediaConnect.

See also: AWS API Documentation

Request Syntax

client.list_router_inputs(
    MaxResults=123,
    NextToken='string',
    Filters=[
        {
            'NameContains': [
                'string',
            ],
            'RegionNames': [
                'string',
            ],
            'NetworkInterfaceArns': [
                'string',
            ],
            'RoutingScopes': [
                'REGIONAL'|'GLOBAL',
            ],
            'InputTypes': [
                'STANDARD'|'FAILOVER'|'MERGE'|'MEDIACONNECT_FLOW'|'MEDIALIVE_CHANNEL',
            ]
        },
    ]
)
type MaxResults:

integer

param MaxResults:

The maximum number of router inputs to return in the response.

type NextToken:

string

param NextToken:

A token used to retrieve the next page of results.

type Filters:

list

param Filters:

The filters to apply when retrieving the list of router inputs.

  • (dict) --

    A filter that can be used to retrieve a list of router inputs.

    • NameContains (list) --

      The names of the router inputs to include in the filter.

      • (string) --

    • RegionNames (list) --

      The AWS Regions of the router inputs to include in the filter.

      • (string) --

    • NetworkInterfaceArns (list) --

      The Amazon Resource Names (ARNs) of the network interfaces associated with the router inputs to include in the filter.

      • (string) --

    • RoutingScopes (list) --

      Filter criteria to list router inputs based on their routing scope (REGIONAL or GLOBAL).

      • (string) --

    • InputTypes (list) --

      The types of router inputs to include in the filter.

      • (string) --

rtype:

dict

returns:

Response Syntax

{
    'RouterInputs': [
        {
            'Name': 'string',
            'Arn': 'string',
            'Id': 'string',
            'InputType': 'STANDARD'|'FAILOVER'|'MERGE'|'MEDIACONNECT_FLOW'|'MEDIALIVE_CHANNEL',
            'State': 'CREATING'|'STANDBY'|'STARTING'|'ACTIVE'|'STOPPING'|'DELETING'|'UPDATING'|'ERROR'|'RECOVERING'|'MIGRATING',
            'RoutedOutputs': 123,
            'RegionName': 'string',
            'AvailabilityZone': 'string',
            'MaximumBitrate': 123,
            'RoutingScope': 'REGIONAL'|'GLOBAL',
            'CreatedAt': datetime(2015, 1, 1),
            'UpdatedAt': datetime(2015, 1, 1),
            'MessageCount': 123,
            'NetworkInterfaceArn': 'string',
            'MaintenanceScheduleType': 'WINDOW',
            'MaintenanceSchedule': {
                'Window': {
                    'Start': datetime(2015, 1, 1),
                    'End': datetime(2015, 1, 1),
                    'ScheduledTime': datetime(2015, 1, 1)
                }
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • RouterInputs (list) --

      The summary information for the retrieved router inputs.

      • (dict) --

        A summary of a router input, including its name, type, ARN, ID, state, and other key details. This structure is used in the response of the ListRouterInputs operation.

        • Name (string) --

          The name of the router input.

        • Arn (string) --

          The Amazon Resource Name (ARN) of the router input.

        • Id (string) --

          The unique identifier of the router input.

        • InputType (string) --

          The type of the router input.

        • State (string) --

          The overall state of the router input.

        • RoutedOutputs (integer) --

          The number of router outputs that are associated with this router input.

        • RegionName (string) --

          The Amazon Web Services Region where the router input is located.

        • AvailabilityZone (string) --

          The Availability Zone of the router input.

        • MaximumBitrate (integer) --

          The maximum bitrate of the router input.

        • RoutingScope (string) --

          Indicates whether the router input is configured for Regional or global routing.

        • CreatedAt (datetime) --

          The timestamp when the router input was created.

        • UpdatedAt (datetime) --

          The timestamp when the router input was last updated.

        • MessageCount (integer) --

          The number of messages associated with the router input.

        • NetworkInterfaceArn (string) --

          The ARN of the network interface associated with the router input.

        • MaintenanceScheduleType (string) --

          The type of maintenance schedule currently associated with the listed router input.

        • MaintenanceSchedule (dict) --

          The details of the maintenance schedule for the listed router input.

          • Window (dict) --

            Defines a specific time window for maintenance operations.

            • Start (datetime) --

              The start time of the maintenance window.

            • End (datetime) --

              The end time of the maintenance window.

            • ScheduledTime (datetime) --

              The date and time when the maintenance window is scheduled to occur.

    • NextToken (string) --

      The token to use to retrieve the next page of results.

UpdateRouterInput (updated) Link ¶
Changes (request, response)
Request
{'Configuration': {'MediaLiveChannel': {'MediaLiveChannelArn': 'string',
                                        'MediaLiveChannelOutputName': 'string',
                                        'MediaLivePipelineId': 'PIPELINE_0 | '
                                                               'PIPELINE_1',
                                        'SourceTransitDecryption': {'EncryptionKeyConfiguration': {'Automatic': {},
                                                                                                   'SecretsManager': {'RoleArn': 'string',
                                                                                                                      'SecretArn': 'string'}},
                                                                    'EncryptionKeyType': 'SECRETS_MANAGER '
                                                                                         '| '
                                                                                         'AUTOMATIC'}}}}
Response
{'RouterInput': {'Configuration': {'MediaLiveChannel': {'MediaLiveChannelArn': 'string',
                                                        'MediaLiveChannelOutputName': 'string',
                                                        'MediaLivePipelineId': 'PIPELINE_0 '
                                                                               '| '
                                                                               'PIPELINE_1',
                                                        'SourceTransitDecryption': {'EncryptionKeyConfiguration': {'Automatic': {},
                                                                                                                   'SecretsManager': {'RoleArn': 'string',
                                                                                                                                      'SecretArn': 'string'}},
                                                                                    'EncryptionKeyType': 'SECRETS_MANAGER '
                                                                                                         '| '
                                                                                                         'AUTOMATIC'}}},
                 'InputType': {'MEDIALIVE_CHANNEL'},
                 'StreamDetails': {'MediaLiveChannel': {}}}}

Updates the configuration of an existing router input in AWS Elemental MediaConnect.

See also: AWS API Documentation

Request Syntax

client.update_router_input(
    Arn='string',
    Name='string',
    Configuration={
        'Standard': {
            'NetworkInterfaceArn': 'string',
            'ProtocolConfiguration': {
                'Rist': {
                    'Port': 123,
                    'RecoveryLatencyMilliseconds': 123
                },
                'SrtListener': {
                    'Port': 123,
                    'MinimumLatencyMilliseconds': 123,
                    'DecryptionConfiguration': {
                        'EncryptionKey': {
                            'SecretArn': 'string',
                            'RoleArn': 'string'
                        }
                    }
                },
                'SrtCaller': {
                    'SourceAddress': 'string',
                    'SourcePort': 123,
                    'MinimumLatencyMilliseconds': 123,
                    'StreamId': 'string',
                    'DecryptionConfiguration': {
                        'EncryptionKey': {
                            'SecretArn': 'string',
                            'RoleArn': 'string'
                        }
                    }
                },
                'Rtp': {
                    'Port': 123,
                    'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                }
            },
            'Protocol': 'RTP'|'RIST'|'SRT_CALLER'|'SRT_LISTENER'
        },
        'MediaLiveChannel': {
            'MediaLiveChannelArn': 'string',
            'MediaLivePipelineId': 'PIPELINE_0'|'PIPELINE_1',
            'MediaLiveChannelOutputName': 'string',
            'SourceTransitDecryption': {
                'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
                'EncryptionKeyConfiguration': {
                    'SecretsManager': {
                        'SecretArn': 'string',
                        'RoleArn': 'string'
                    },
                    'Automatic': {}

                }
            }
        },
        'Failover': {
            'NetworkInterfaceArn': 'string',
            'ProtocolConfigurations': [
                {
                    'Rist': {
                        'Port': 123,
                        'RecoveryLatencyMilliseconds': 123
                    },
                    'SrtListener': {
                        'Port': 123,
                        'MinimumLatencyMilliseconds': 123,
                        'DecryptionConfiguration': {
                            'EncryptionKey': {
                                'SecretArn': 'string',
                                'RoleArn': 'string'
                            }
                        }
                    },
                    'SrtCaller': {
                        'SourceAddress': 'string',
                        'SourcePort': 123,
                        'MinimumLatencyMilliseconds': 123,
                        'StreamId': 'string',
                        'DecryptionConfiguration': {
                            'EncryptionKey': {
                                'SecretArn': 'string',
                                'RoleArn': 'string'
                            }
                        }
                    },
                    'Rtp': {
                        'Port': 123,
                        'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                    }
                },
            ],
            'SourcePriorityMode': 'NO_PRIORITY'|'PRIMARY_SECONDARY',
            'PrimarySourceIndex': 123
        },
        'MediaConnectFlow': {
            'FlowArn': 'string',
            'FlowOutputArn': 'string',
            'SourceTransitDecryption': {
                'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
                'EncryptionKeyConfiguration': {
                    'SecretsManager': {
                        'SecretArn': 'string',
                        'RoleArn': 'string'
                    },
                    'Automatic': {}

                }
            }
        },
        'Merge': {
            'NetworkInterfaceArn': 'string',
            'ProtocolConfigurations': [
                {
                    'Rtp': {
                        'Port': 123,
                        'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                    },
                    'Rist': {
                        'Port': 123,
                        'RecoveryLatencyMilliseconds': 123
                    }
                },
            ],
            'MergeRecoveryWindowMilliseconds': 123
        }
    },
    MaximumBitrate=123,
    RoutingScope='REGIONAL'|'GLOBAL',
    Tier='INPUT_100'|'INPUT_50'|'INPUT_20',
    TransitEncryption={
        'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
        'EncryptionKeyConfiguration': {
            'SecretsManager': {
                'SecretArn': 'string',
                'RoleArn': 'string'
            },
            'Automatic': {}

        }
    },
    MaintenanceConfiguration={
        'PreferredDayTime': {
            'Day': 'MONDAY'|'TUESDAY'|'WEDNESDAY'|'THURSDAY'|'FRIDAY'|'SATURDAY'|'SUNDAY',
            'Time': 'string'
        },
        'Default': {}

    }
)
type Arn:

string

param Arn:

[REQUIRED]

The Amazon Resource Name (ARN) of the router input that you want to update.

type Name:

string

param Name:

The updated name for the router input.

type Configuration:

dict

param Configuration:

The updated configuration settings for the router input. Changing the type of the configuration is not supported.

  • Standard (dict) --

    The configuration settings for a standard router input, including the protocol, protocol-specific configuration, network interface, and availability zone.

    • NetworkInterfaceArn (string) -- [REQUIRED]

      The Amazon Resource Name (ARN) of the network interface associated with the standard router input.

    • ProtocolConfiguration (dict) -- [REQUIRED]

      The configuration settings for the protocol used by the standard router input.

      • Rist (dict) --

        The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

        • Port (integer) -- [REQUIRED]

          The port number used for the RIST protocol in the router input configuration.

        • RecoveryLatencyMilliseconds (integer) -- [REQUIRED]

          The recovery latency in milliseconds for the RIST protocol in the router input configuration.

      • SrtListener (dict) --

        The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in listener mode, including the port, minimum latency, and decryption key configuration.

        • Port (integer) -- [REQUIRED]

          The port number for the SRT protocol in listener mode.

        • MinimumLatencyMilliseconds (integer) -- [REQUIRED]

          The minimum latency in milliseconds for the SRT protocol in listener mode.

        • DecryptionConfiguration (dict) --

          Specifies the decryption settings for an SRT listener input, including the encryption key configuration and associated parameters.

          • EncryptionKey (dict) -- [REQUIRED]

            Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

            • SecretArn (string) -- [REQUIRED]

              The ARN of the Secrets Manager secret used for transit encryption.

            • RoleArn (string) -- [REQUIRED]

              The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

      • SrtCaller (dict) --

        The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in caller mode, including the source address and port, minimum latency, stream ID, and decryption key configuration.

        • SourceAddress (string) -- [REQUIRED]

          The source IP address for the SRT protocol in caller mode.

        • SourcePort (integer) -- [REQUIRED]

          The source port number for the SRT protocol in caller mode.

        • MinimumLatencyMilliseconds (integer) -- [REQUIRED]

          The minimum latency in milliseconds for the SRT protocol in caller mode.

        • StreamId (string) --

          The stream ID for the SRT protocol in caller mode.

        • DecryptionConfiguration (dict) --

          Specifies the decryption settings for an SRT caller input, including the encryption key configuration and associated parameters.

          • EncryptionKey (dict) -- [REQUIRED]

            Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

            • SecretArn (string) -- [REQUIRED]

              The ARN of the Secrets Manager secret used for transit encryption.

            • RoleArn (string) -- [REQUIRED]

              The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

      • Rtp (dict) --

        The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

        • Port (integer) -- [REQUIRED]

          The port number used for the RTP protocol in the router input configuration.

        • ForwardErrorCorrection (string) --

          The state of forward error correction for the RTP protocol in the router input configuration.

    • Protocol (string) --

      The protocol used by the standard router input.

  • MediaLiveChannel (dict) --

    Configuration settings for connecting a router input to a MediaLive channel output.

    • MediaLiveChannelArn (string) --

      The ARN of the MediaLive channel to connect to this router input.

    • MediaLivePipelineId (string) --

      The index of the MediaLive pipeline to connect to this router input.

    • MediaLiveChannelOutputName (string) --

      The name of the MediaLive channel output to connect to this router input.

    • SourceTransitDecryption (dict) -- [REQUIRED]

      The encryption configuration that defines how content is encrypted during transit between MediaConnect Router and MediaLive. This configuration determines whether encryption keys are automatically managed by the service or manually managed through Secrets Manager.

      • EncryptionKeyType (string) --

        The type of encryption key to use for MediaLive transit encryption.

      • EncryptionKeyConfiguration (dict) -- [REQUIRED]

        The configuration details for the MediaLive encryption key.

        • SecretsManager (dict) --

          The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

          • SecretArn (string) -- [REQUIRED]

            The ARN of the Secrets Manager secret used for transit encryption.

          • RoleArn (string) -- [REQUIRED]

            The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

        • Automatic (dict) --

          Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

  • Failover (dict) --

    Configuration settings for a failover router input that allows switching between two input sources.

    • NetworkInterfaceArn (string) -- [REQUIRED]

      The ARN of the network interface to use for this failover router input.

    • ProtocolConfigurations (list) -- [REQUIRED]

      A list of exactly two protocol configurations for the failover input sources. Both must use the same protocol type.

      • (dict) --

        Protocol configuration settings for failover router inputs.

        • Rist (dict) --

          The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

          • Port (integer) -- [REQUIRED]

            The port number used for the RIST protocol in the router input configuration.

          • RecoveryLatencyMilliseconds (integer) -- [REQUIRED]

            The recovery latency in milliseconds for the RIST protocol in the router input configuration.

        • SrtListener (dict) --

          The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in listener mode, including the port, minimum latency, and decryption key configuration.

          • Port (integer) -- [REQUIRED]

            The port number for the SRT protocol in listener mode.

          • MinimumLatencyMilliseconds (integer) -- [REQUIRED]

            The minimum latency in milliseconds for the SRT protocol in listener mode.

          • DecryptionConfiguration (dict) --

            Specifies the decryption settings for an SRT listener input, including the encryption key configuration and associated parameters.

            • EncryptionKey (dict) -- [REQUIRED]

              Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

              • SecretArn (string) -- [REQUIRED]

                The ARN of the Secrets Manager secret used for transit encryption.

              • RoleArn (string) -- [REQUIRED]

                The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

        • SrtCaller (dict) --

          The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in caller mode, including the source address and port, minimum latency, stream ID, and decryption key configuration.

          • SourceAddress (string) -- [REQUIRED]

            The source IP address for the SRT protocol in caller mode.

          • SourcePort (integer) -- [REQUIRED]

            The source port number for the SRT protocol in caller mode.

          • MinimumLatencyMilliseconds (integer) -- [REQUIRED]

            The minimum latency in milliseconds for the SRT protocol in caller mode.

          • StreamId (string) --

            The stream ID for the SRT protocol in caller mode.

          • DecryptionConfiguration (dict) --

            Specifies the decryption settings for an SRT caller input, including the encryption key configuration and associated parameters.

            • EncryptionKey (dict) -- [REQUIRED]

              Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

              • SecretArn (string) -- [REQUIRED]

                The ARN of the Secrets Manager secret used for transit encryption.

              • RoleArn (string) -- [REQUIRED]

                The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

        • Rtp (dict) --

          The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

          • Port (integer) -- [REQUIRED]

            The port number used for the RTP protocol in the router input configuration.

          • ForwardErrorCorrection (string) --

            The state of forward error correction for the RTP protocol in the router input configuration.

    • SourcePriorityMode (string) -- [REQUIRED]

      The mode for determining source priority in failover configurations.

    • PrimarySourceIndex (integer) --

      The index (0 or 1) that specifies which source in the protocol configurations list is currently active. Used to control which of the two failover sources is currently selected. This field is ignored when sourcePriorityMode is set to NO_PRIORITY

  • MediaConnectFlow (dict) --

    Configuration settings for connecting a router input to a flow output.

    • FlowArn (string) --

      The ARN of the flow to connect to.

    • FlowOutputArn (string) --

      The ARN of the flow output to connect to this router input.

    • SourceTransitDecryption (dict) -- [REQUIRED]

      The decryption configuration for the flow source when connected to this router input.

      • EncryptionKeyType (string) --

        The type of encryption key to use for flow transit encryption.

      • EncryptionKeyConfiguration (dict) -- [REQUIRED]

        The configuration details for the encryption key.

        • SecretsManager (dict) --

          The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

          • SecretArn (string) -- [REQUIRED]

            The ARN of the Secrets Manager secret used for transit encryption.

          • RoleArn (string) -- [REQUIRED]

            The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

        • Automatic (dict) --

          Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

  • Merge (dict) --

    Configuration settings for a merge router input that combines two input sources.

    • NetworkInterfaceArn (string) -- [REQUIRED]

      The ARN of the network interface to use for this merge router input.

    • ProtocolConfigurations (list) -- [REQUIRED]

      A list of exactly two protocol configurations for the merge input sources. Both must use the same protocol type.

      • (dict) --

        Protocol configuration settings for merge router inputs.

        • Rtp (dict) --

          The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

          • Port (integer) -- [REQUIRED]

            The port number used for the RTP protocol in the router input configuration.

          • ForwardErrorCorrection (string) --

            The state of forward error correction for the RTP protocol in the router input configuration.

        • Rist (dict) --

          The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

          • Port (integer) -- [REQUIRED]

            The port number used for the RIST protocol in the router input configuration.

          • RecoveryLatencyMilliseconds (integer) -- [REQUIRED]

            The recovery latency in milliseconds for the RIST protocol in the router input configuration.

    • MergeRecoveryWindowMilliseconds (integer) -- [REQUIRED]

      The time window in milliseconds for merging the two input sources.

type MaximumBitrate:

integer

param MaximumBitrate:

The updated maximum bitrate for the router input.

type RoutingScope:

string

param RoutingScope:

Specifies whether the router input can be assigned to outputs in different Regions. REGIONAL (default) - can be assigned only to outputs in the same Region. GLOBAL - can be assigned to outputs in any Region.

type Tier:

string

param Tier:

The updated tier level for the router input.

type TransitEncryption:

dict

param TransitEncryption:

The updated transit encryption settings for the router input.

  • EncryptionKeyType (string) --

    Specifies the type of encryption key to use for transit encryption.

  • EncryptionKeyConfiguration (dict) -- [REQUIRED]

    Contains the configuration details for the encryption key used in transit encryption, including the key source and associated parameters.

    • SecretsManager (dict) --

      The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

      • SecretArn (string) -- [REQUIRED]

        The ARN of the Secrets Manager secret used for transit encryption.

      • RoleArn (string) -- [REQUIRED]

        The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

    • Automatic (dict) --

      Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

type MaintenanceConfiguration:

dict

param MaintenanceConfiguration:

The updated maintenance configuration settings for the router input, including any changes to preferred maintenance windows and schedules.

  • PreferredDayTime (dict) --

    Preferred day and time maintenance configuration settings.

    • Day (string) -- [REQUIRED]

      The preferred day for maintenance operations.

    • Time (string) -- [REQUIRED]

      The preferred time for maintenance operations.

  • Default (dict) --

    Default maintenance configuration settings.

rtype:

dict

returns:

Response Syntax

{
    'RouterInput': {
        'Name': 'string',
        'Arn': 'string',
        'Id': 'string',
        'State': 'CREATING'|'STANDBY'|'STARTING'|'ACTIVE'|'STOPPING'|'DELETING'|'UPDATING'|'ERROR'|'RECOVERING'|'MIGRATING',
        'InputType': 'STANDARD'|'FAILOVER'|'MERGE'|'MEDIACONNECT_FLOW'|'MEDIALIVE_CHANNEL',
        'Configuration': {
            'Standard': {
                'NetworkInterfaceArn': 'string',
                'ProtocolConfiguration': {
                    'Rist': {
                        'Port': 123,
                        'RecoveryLatencyMilliseconds': 123
                    },
                    'SrtListener': {
                        'Port': 123,
                        'MinimumLatencyMilliseconds': 123,
                        'DecryptionConfiguration': {
                            'EncryptionKey': {
                                'SecretArn': 'string',
                                'RoleArn': 'string'
                            }
                        }
                    },
                    'SrtCaller': {
                        'SourceAddress': 'string',
                        'SourcePort': 123,
                        'MinimumLatencyMilliseconds': 123,
                        'StreamId': 'string',
                        'DecryptionConfiguration': {
                            'EncryptionKey': {
                                'SecretArn': 'string',
                                'RoleArn': 'string'
                            }
                        }
                    },
                    'Rtp': {
                        'Port': 123,
                        'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                    }
                },
                'Protocol': 'RTP'|'RIST'|'SRT_CALLER'|'SRT_LISTENER'
            },
            'MediaLiveChannel': {
                'MediaLiveChannelArn': 'string',
                'MediaLivePipelineId': 'PIPELINE_0'|'PIPELINE_1',
                'MediaLiveChannelOutputName': 'string',
                'SourceTransitDecryption': {
                    'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
                    'EncryptionKeyConfiguration': {
                        'SecretsManager': {
                            'SecretArn': 'string',
                            'RoleArn': 'string'
                        },
                        'Automatic': {}
                    }
                }
            },
            'Failover': {
                'NetworkInterfaceArn': 'string',
                'ProtocolConfigurations': [
                    {
                        'Rist': {
                            'Port': 123,
                            'RecoveryLatencyMilliseconds': 123
                        },
                        'SrtListener': {
                            'Port': 123,
                            'MinimumLatencyMilliseconds': 123,
                            'DecryptionConfiguration': {
                                'EncryptionKey': {
                                    'SecretArn': 'string',
                                    'RoleArn': 'string'
                                }
                            }
                        },
                        'SrtCaller': {
                            'SourceAddress': 'string',
                            'SourcePort': 123,
                            'MinimumLatencyMilliseconds': 123,
                            'StreamId': 'string',
                            'DecryptionConfiguration': {
                                'EncryptionKey': {
                                    'SecretArn': 'string',
                                    'RoleArn': 'string'
                                }
                            }
                        },
                        'Rtp': {
                            'Port': 123,
                            'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                        }
                    },
                ],
                'SourcePriorityMode': 'NO_PRIORITY'|'PRIMARY_SECONDARY',
                'PrimarySourceIndex': 123
            },
            'MediaConnectFlow': {
                'FlowArn': 'string',
                'FlowOutputArn': 'string',
                'SourceTransitDecryption': {
                    'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
                    'EncryptionKeyConfiguration': {
                        'SecretsManager': {
                            'SecretArn': 'string',
                            'RoleArn': 'string'
                        },
                        'Automatic': {}
                    }
                }
            },
            'Merge': {
                'NetworkInterfaceArn': 'string',
                'ProtocolConfigurations': [
                    {
                        'Rtp': {
                            'Port': 123,
                            'ForwardErrorCorrection': 'ENABLED'|'DISABLED'
                        },
                        'Rist': {
                            'Port': 123,
                            'RecoveryLatencyMilliseconds': 123
                        }
                    },
                ],
                'MergeRecoveryWindowMilliseconds': 123
            }
        },
        'RoutedOutputs': 123,
        'MaximumRoutedOutputs': 123,
        'RegionName': 'string',
        'AvailabilityZone': 'string',
        'MaximumBitrate': 123,
        'Tier': 'INPUT_100'|'INPUT_50'|'INPUT_20',
        'RoutingScope': 'REGIONAL'|'GLOBAL',
        'CreatedAt': datetime(2015, 1, 1),
        'UpdatedAt': datetime(2015, 1, 1),
        'Messages': [
            {
                'Code': 'string',
                'Message': 'string'
            },
        ],
        'TransitEncryption': {
            'EncryptionKeyType': 'SECRETS_MANAGER'|'AUTOMATIC',
            'EncryptionKeyConfiguration': {
                'SecretsManager': {
                    'SecretArn': 'string',
                    'RoleArn': 'string'
                },
                'Automatic': {}
            }
        },
        'Tags': {
            'string': 'string'
        },
        'StreamDetails': {
            'Standard': {
                'SourceIpAddress': 'string'
            },
            'MediaLiveChannel': {},
            'Failover': {
                'SourceIndexZeroStreamDetails': {
                    'SourceIndex': 123,
                    'SourceIpAddress': 'string'
                },
                'SourceIndexOneStreamDetails': {
                    'SourceIndex': 123,
                    'SourceIpAddress': 'string'
                }
            },
            'MediaConnectFlow': {},
            'Merge': {
                'SourceIndexZeroStreamDetails': {
                    'SourceIndex': 123,
                    'SourceIpAddress': 'string'
                },
                'SourceIndexOneStreamDetails': {
                    'SourceIndex': 123,
                    'SourceIpAddress': 'string'
                }
            }
        },
        'IpAddress': 'string',
        'MaintenanceType': 'PREFERRED_DAY_TIME'|'DEFAULT',
        'MaintenanceConfiguration': {
            'PreferredDayTime': {
                'Day': 'MONDAY'|'TUESDAY'|'WEDNESDAY'|'THURSDAY'|'FRIDAY'|'SATURDAY'|'SUNDAY',
                'Time': 'string'
            },
            'Default': {}
        },
        'MaintenanceScheduleType': 'WINDOW',
        'MaintenanceSchedule': {
            'Window': {
                'Start': datetime(2015, 1, 1),
                'End': datetime(2015, 1, 1),
                'ScheduledTime': datetime(2015, 1, 1)
            }
        }
    }
}

Response Structure

  • (dict) --

    • RouterInput (dict) --

      The updated router input.

      • Name (string) --

        The name of the router input.

      • Arn (string) --

        The Amazon Resource Name (ARN) of the router input.

      • Id (string) --

        The unique identifier of the router input.

      • State (string) --

        The current state of the router input.

      • InputType (string) --

        The type of the router input.

      • Configuration (dict) --

        The configuration settings for a router input.

        • Standard (dict) --

          The configuration settings for a standard router input, including the protocol, protocol-specific configuration, network interface, and availability zone.

          • NetworkInterfaceArn (string) --

            The Amazon Resource Name (ARN) of the network interface associated with the standard router input.

          • ProtocolConfiguration (dict) --

            The configuration settings for the protocol used by the standard router input.

            • Rist (dict) --

              The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

              • Port (integer) --

                The port number used for the RIST protocol in the router input configuration.

              • RecoveryLatencyMilliseconds (integer) --

                The recovery latency in milliseconds for the RIST protocol in the router input configuration.

            • SrtListener (dict) --

              The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in listener mode, including the port, minimum latency, and decryption key configuration.

              • Port (integer) --

                The port number for the SRT protocol in listener mode.

              • MinimumLatencyMilliseconds (integer) --

                The minimum latency in milliseconds for the SRT protocol in listener mode.

              • DecryptionConfiguration (dict) --

                Specifies the decryption settings for an SRT listener input, including the encryption key configuration and associated parameters.

                • EncryptionKey (dict) --

                  Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                  • SecretArn (string) --

                    The ARN of the Secrets Manager secret used for transit encryption.

                  • RoleArn (string) --

                    The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

            • SrtCaller (dict) --

              The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in caller mode, including the source address and port, minimum latency, stream ID, and decryption key configuration.

              • SourceAddress (string) --

                The source IP address for the SRT protocol in caller mode.

              • SourcePort (integer) --

                The source port number for the SRT protocol in caller mode.

              • MinimumLatencyMilliseconds (integer) --

                The minimum latency in milliseconds for the SRT protocol in caller mode.

              • StreamId (string) --

                The stream ID for the SRT protocol in caller mode.

              • DecryptionConfiguration (dict) --

                Specifies the decryption settings for an SRT caller input, including the encryption key configuration and associated parameters.

                • EncryptionKey (dict) --

                  Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                  • SecretArn (string) --

                    The ARN of the Secrets Manager secret used for transit encryption.

                  • RoleArn (string) --

                    The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

            • Rtp (dict) --

              The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

              • Port (integer) --

                The port number used for the RTP protocol in the router input configuration.

              • ForwardErrorCorrection (string) --

                The state of forward error correction for the RTP protocol in the router input configuration.

          • Protocol (string) --

            The protocol used by the standard router input.

        • MediaLiveChannel (dict) --

          Configuration settings for connecting a router input to a MediaLive channel output.

          • MediaLiveChannelArn (string) --

            The ARN of the MediaLive channel to connect to this router input.

          • MediaLivePipelineId (string) --

            The index of the MediaLive pipeline to connect to this router input.

          • MediaLiveChannelOutputName (string) --

            The name of the MediaLive channel output to connect to this router input.

          • SourceTransitDecryption (dict) --

            The encryption configuration that defines how content is encrypted during transit between MediaConnect Router and MediaLive. This configuration determines whether encryption keys are automatically managed by the service or manually managed through Secrets Manager.

            • EncryptionKeyType (string) --

              The type of encryption key to use for MediaLive transit encryption.

            • EncryptionKeyConfiguration (dict) --

              The configuration details for the MediaLive encryption key.

              • SecretsManager (dict) --

                The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

                • SecretArn (string) --

                  The ARN of the Secrets Manager secret used for transit encryption.

                • RoleArn (string) --

                  The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • Automatic (dict) --

                Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

        • Failover (dict) --

          Configuration settings for a failover router input that allows switching between two input sources.

          • NetworkInterfaceArn (string) --

            The ARN of the network interface to use for this failover router input.

          • ProtocolConfigurations (list) --

            A list of exactly two protocol configurations for the failover input sources. Both must use the same protocol type.

            • (dict) --

              Protocol configuration settings for failover router inputs.

              • Rist (dict) --

                The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

                • Port (integer) --

                  The port number used for the RIST protocol in the router input configuration.

                • RecoveryLatencyMilliseconds (integer) --

                  The recovery latency in milliseconds for the RIST protocol in the router input configuration.

              • SrtListener (dict) --

                The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in listener mode, including the port, minimum latency, and decryption key configuration.

                • Port (integer) --

                  The port number for the SRT protocol in listener mode.

                • MinimumLatencyMilliseconds (integer) --

                  The minimum latency in milliseconds for the SRT protocol in listener mode.

                • DecryptionConfiguration (dict) --

                  Specifies the decryption settings for an SRT listener input, including the encryption key configuration and associated parameters.

                  • EncryptionKey (dict) --

                    Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                    • SecretArn (string) --

                      The ARN of the Secrets Manager secret used for transit encryption.

                    • RoleArn (string) --

                      The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • SrtCaller (dict) --

                The configuration settings for a router input using the SRT (Secure Reliable Transport) protocol in caller mode, including the source address and port, minimum latency, stream ID, and decryption key configuration.

                • SourceAddress (string) --

                  The source IP address for the SRT protocol in caller mode.

                • SourcePort (integer) --

                  The source port number for the SRT protocol in caller mode.

                • MinimumLatencyMilliseconds (integer) --

                  The minimum latency in milliseconds for the SRT protocol in caller mode.

                • StreamId (string) --

                  The stream ID for the SRT protocol in caller mode.

                • DecryptionConfiguration (dict) --

                  Specifies the decryption settings for an SRT caller input, including the encryption key configuration and associated parameters.

                  • EncryptionKey (dict) --

                    Specifies the encryption key configuration used for decrypting SRT streams, including the key source and associated credentials.

                    • SecretArn (string) --

                      The ARN of the Secrets Manager secret used for transit encryption.

                    • RoleArn (string) --

                      The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • Rtp (dict) --

                The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

                • Port (integer) --

                  The port number used for the RTP protocol in the router input configuration.

                • ForwardErrorCorrection (string) --

                  The state of forward error correction for the RTP protocol in the router input configuration.

          • SourcePriorityMode (string) --

            The mode for determining source priority in failover configurations.

          • PrimarySourceIndex (integer) --

            The index (0 or 1) that specifies which source in the protocol configurations list is currently active. Used to control which of the two failover sources is currently selected. This field is ignored when sourcePriorityMode is set to NO_PRIORITY

        • MediaConnectFlow (dict) --

          Configuration settings for connecting a router input to a flow output.

          • FlowArn (string) --

            The ARN of the flow to connect to.

          • FlowOutputArn (string) --

            The ARN of the flow output to connect to this router input.

          • SourceTransitDecryption (dict) --

            The decryption configuration for the flow source when connected to this router input.

            • EncryptionKeyType (string) --

              The type of encryption key to use for flow transit encryption.

            • EncryptionKeyConfiguration (dict) --

              The configuration details for the encryption key.

              • SecretsManager (dict) --

                The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

                • SecretArn (string) --

                  The ARN of the Secrets Manager secret used for transit encryption.

                • RoleArn (string) --

                  The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

              • Automatic (dict) --

                Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

        • Merge (dict) --

          Configuration settings for a merge router input that combines two input sources.

          • NetworkInterfaceArn (string) --

            The ARN of the network interface to use for this merge router input.

          • ProtocolConfigurations (list) --

            A list of exactly two protocol configurations for the merge input sources. Both must use the same protocol type.

            • (dict) --

              Protocol configuration settings for merge router inputs.

              • Rtp (dict) --

                The configuration settings for a Router Input using the RTP (Real-Time Transport Protocol) protocol, including the port and forward error correction state.

                • Port (integer) --

                  The port number used for the RTP protocol in the router input configuration.

                • ForwardErrorCorrection (string) --

                  The state of forward error correction for the RTP protocol in the router input configuration.

              • Rist (dict) --

                The configuration settings for a router input using the RIST (Reliable Internet Stream Transport) protocol, including the port and recovery latency.

                • Port (integer) --

                  The port number used for the RIST protocol in the router input configuration.

                • RecoveryLatencyMilliseconds (integer) --

                  The recovery latency in milliseconds for the RIST protocol in the router input configuration.

          • MergeRecoveryWindowMilliseconds (integer) --

            The time window in milliseconds for merging the two input sources.

      • RoutedOutputs (integer) --

        The number of router outputs associated with the router input.

      • MaximumRoutedOutputs (integer) --

        The maximum number of outputs that can be simultaneously routed to this input.

      • RegionName (string) --

        The Amazon Web Services Region where the router input is located.

      • AvailabilityZone (string) --

        The Availability Zone of the router input.

      • MaximumBitrate (integer) --

        The maximum bitrate for the router input.

      • Tier (string) --

        The tier level of the router input.

      • RoutingScope (string) --

        Indicates whether the router input is configured for Regional or global routing.

      • CreatedAt (datetime) --

        The timestamp when the router input was created.

      • UpdatedAt (datetime) --

        The timestamp when the router input was last updated.

      • Messages (list) --

        The messages associated with the router input.

        • (dict) --

          A message associated with a router input, including a code and a message.

          • Code (string) --

            The code associated with the router input message.

          • Message (string) --

            The message text associated with the router input message.

      • TransitEncryption (dict) --

        The transit encryption settings for a router input.

        • EncryptionKeyType (string) --

          Specifies the type of encryption key to use for transit encryption.

        • EncryptionKeyConfiguration (dict) --

          Contains the configuration details for the encryption key used in transit encryption, including the key source and associated parameters.

          • SecretsManager (dict) --

            The configuration settings for transit encryption using Secrets Manager, including the secret ARN and role ARN.

            • SecretArn (string) --

              The ARN of the Secrets Manager secret used for transit encryption.

            • RoleArn (string) --

              The ARN of the IAM role assumed by MediaConnect to access the Secrets Manager secret.

          • Automatic (dict) --

            Configuration settings for automatic encryption key management, where MediaConnect handles key creation and rotation.

      • Tags (dict) --

        Key-value pairs that can be used to tag and organize this router input.

        • (string) --

          • (string) --

      • StreamDetails (dict) --

        Configuration details for the router input stream.

        • Standard (dict) --

          Configuration details for a standard router input stream type.

          • SourceIpAddress (string) --

            The source IP address for the standard router input stream.

        • MediaLiveChannel (dict) --

          Configuration details for a MediaLive channel when used as a router input source.

        • Failover (dict) --

          Configuration details for a failover router input that can automatically switch between two sources.

          • SourceIndexZeroStreamDetails (dict) --

            Configuration details for the primary source (index 0) in the failover setup.

            • SourceIndex (integer) --

              The index number (0 or 1) assigned to this source in the failover configuration.

            • SourceIpAddress (string) --

              The IP address of the source for this indexed stream.

          • SourceIndexOneStreamDetails (dict) --

            Configuration details for the secondary source (index 1) in the failover setup.

            • SourceIndex (integer) --

              The index number (0 or 1) assigned to this source in the failover configuration.

            • SourceIpAddress (string) --

              The IP address of the source for this indexed stream.

        • MediaConnectFlow (dict) --

          Configuration details for a MediaConnect flow when used as a router input source.

        • Merge (dict) --

          Configuration details for a merge router input that combines two input sources.

          • SourceIndexZeroStreamDetails (dict) --

            Configuration details for the first source (index 0) in the merge setup.

            • SourceIndex (integer) --

              The index number (0 or 1) assigned to this source in the merge configuration.

            • SourceIpAddress (string) --

              The IP address of the source for this indexed stream in the merge setup.

          • SourceIndexOneStreamDetails (dict) --

            Configuration details for the second source (index 1) in the merge setup.

            • SourceIndex (integer) --

              The index number (0 or 1) assigned to this source in the merge configuration.

            • SourceIpAddress (string) --

              The IP address of the source for this indexed stream in the merge setup.

      • IpAddress (string) --

        The IP address of the router input.

      • MaintenanceType (string) --

        The type of maintenance configuration applied to this router input.

      • MaintenanceConfiguration (dict) --

        The maintenance configuration settings applied to this router input.

        • PreferredDayTime (dict) --

          Preferred day and time maintenance configuration settings.

          • Day (string) --

            The preferred day for maintenance operations.

          • Time (string) --

            The preferred time for maintenance operations.

        • Default (dict) --

          Default maintenance configuration settings.

      • MaintenanceScheduleType (string) --

        The type of maintenance schedule currently in effect for this router input.

      • MaintenanceSchedule (dict) --

        The current maintenance schedule details for this router input.

        • Window (dict) --

          Defines a specific time window for maintenance operations.

          • Start (datetime) --

            The start time of the maintenance window.

          • End (datetime) --

            The end time of the maintenance window.

          • ScheduledTime (datetime) --

            The date and time when the maintenance window is scheduled to occur.