Skip to content
v2.278.0

Experimental

@aws-cdk/aws-medialive-alpha is an experimental (alpha) package: its API may change in any release, without a major version bump.

MediaConnectRouterOutputGroupProps Struct ​

Properties for a MediaConnect Router output group.

Delivers each channel pipeline to a MediaConnect Router. The downstream routing (which router input each pipeline feeds) is configured on the MediaConnect side, referencing this group by name and pipeline id.

Example ​

ts
declare const video: medialive.EncodeConfiguration;
declare const audio: medialive.EncodeConfiguration;
declare const passphrase: secretsmanager.ISecret;
declare const passphrase1: secretsmanager.ISecret;

// AUTOMATIC encryption on every pipeline (MPEG-TS container, like UDP)
medialive.OutputGroupConfiguration.mediaConnectRouter({
  name: 'router_out',
  availabilityZones: ['us-east-1a'],
  outputs: [{ encodes: [video, audio], outputName: 'router_ts' }],
});

// One shared Secrets Manager passphrase across all pipelines (SECRETS_MANAGER encryption)
medialive.OutputGroupConfiguration.mediaConnectRouter({
  name: 'router_out',
  availabilityZones: ['us-east-1a'],
  routerSettings: medialive.MediaConnectRouterSettings.shared({ encryptionSecret: passphrase }),
  outputs: [{ encodes: [video, audio], outputName: 'router_ts' }],
});

// Distinct encryption per pipeline — an omitted pipeline stays AUTOMATIC (STANDARD channels)
medialive.OutputGroupConfiguration.mediaConnectRouter({
  name: 'router_out',
  availabilityZones: ['us-east-1a', 'us-east-1b'],
  routerSettings: medialive.MediaConnectRouterSettings.perPipeline({
    pipeline1: { encryptionSecret: passphrase1 },
  }),
  outputs: [{ encodes: [video, audio], outputName: 'router_ts' }],
});
python
# video: medialive.EncodeConfiguration
# audio: medialive.EncodeConfiguration
# passphrase: secretsmanager.ISecret
# passphrase1: secretsmanager.ISecret


# AUTOMATIC encryption on every pipeline (MPEG-TS container, like UDP)
medialive.OutputGroupConfiguration.media_connect_router(
    name="router_out",
    availability_zones=["us-east-1a"],
    outputs=[medialive.MediaConnectRouterOutputDefinition(encodes=[video, audio], output_name="router_ts")]
)

# One shared Secrets Manager passphrase across all pipelines (SECRETS_MANAGER encryption)
medialive.OutputGroupConfiguration.media_connect_router(
    name="router_out",
    availability_zones=["us-east-1a"],
    router_settings=medialive.MediaConnectRouterSettings.shared(encryption_secret=passphrase),
    outputs=[medialive.MediaConnectRouterOutputDefinition(encodes=[video, audio], output_name="router_ts")]
)

# Distinct encryption per pipeline — an omitted pipeline stays AUTOMATIC (STANDARD channels)
medialive.OutputGroupConfiguration.media_connect_router(
    name="router_out",
    availability_zones=["us-east-1a", "us-east-1b"],
    router_settings=medialive.MediaConnectRouterSettings.per_pipeline(
        pipeline1=medialive.MediaConnectRouterPipelineConfig(encryption_secret=passphrase1)
    ),
    outputs=[medialive.MediaConnectRouterOutputDefinition(encodes=[video, audio], output_name="router_ts")]
)
java
EncodeConfiguration video;
EncodeConfiguration audio;
ISecret passphrase;
ISecret passphrase1;


// AUTOMATIC encryption on every pipeline (MPEG-TS container, like UDP)
OutputGroupConfiguration.mediaConnectRouter(MediaConnectRouterOutputGroupProps.builder()
        .name("router_out")
        .availabilityZones(List.of("us-east-1a"))
        .outputs(List.of(MediaConnectRouterOutputDefinition.builder().encodes(List.of(video, audio)).outputName("router_ts").build()))
        .build());

// One shared Secrets Manager passphrase across all pipelines (SECRETS_MANAGER encryption)
OutputGroupConfiguration.mediaConnectRouter(MediaConnectRouterOutputGroupProps.builder()
        .name("router_out")
        .availabilityZones(List.of("us-east-1a"))
        .routerSettings(MediaConnectRouterSettings.shared(MediaConnectRouterPipelineConfig.builder().encryptionSecret(passphrase).build()))
        .outputs(List.of(MediaConnectRouterOutputDefinition.builder().encodes(List.of(video, audio)).outputName("router_ts").build()))
        .build());

// Distinct encryption per pipeline — an omitted pipeline stays AUTOMATIC (STANDARD channels)
OutputGroupConfiguration.mediaConnectRouter(MediaConnectRouterOutputGroupProps.builder()
        .name("router_out")
        .availabilityZones(List.of("us-east-1a", "us-east-1b"))
        .routerSettings(MediaConnectRouterSettings.perPipeline(MediaConnectRouterPerPipelineSettings.builder()
                .pipeline1(MediaConnectRouterPipelineConfig.builder().encryptionSecret(passphrase1).build())
                .build()))
        .outputs(List.of(MediaConnectRouterOutputDefinition.builder().encodes(List.of(video, audio)).outputName("router_ts").build()))
        .build());
csharp
// Install: dotnet add package Amazon.CDK.AWS.MediaLive.Alpha
EncodeConfiguration video;
EncodeConfiguration audio;
ISecret passphrase;
ISecret passphrase1;


// AUTOMATIC encryption on every pipeline (MPEG-TS container, like UDP)
OutputGroupConfiguration.MediaConnectRouter(new MediaConnectRouterOutputGroupProps {
    Name = "router_out",
    AvailabilityZones = new [] { "us-east-1a" },
    Outputs = new [] { new MediaConnectRouterOutputDefinition { Encodes = new [] { video, audio }, OutputName = "router_ts" } }
});

// One shared Secrets Manager passphrase across all pipelines (SECRETS_MANAGER encryption)
OutputGroupConfiguration.MediaConnectRouter(new MediaConnectRouterOutputGroupProps {
    Name = "router_out",
    AvailabilityZones = new [] { "us-east-1a" },
    RouterSettings = MediaConnectRouterSettings.Shared(new MediaConnectRouterPipelineConfig { EncryptionSecret = passphrase }),
    Outputs = new [] { new MediaConnectRouterOutputDefinition { Encodes = new [] { video, audio }, OutputName = "router_ts" } }
});

// Distinct encryption per pipeline — an omitted pipeline stays AUTOMATIC (STANDARD channels)
OutputGroupConfiguration.MediaConnectRouter(new MediaConnectRouterOutputGroupProps {
    Name = "router_out",
    AvailabilityZones = new [] { "us-east-1a", "us-east-1b" },
    RouterSettings = MediaConnectRouterSettings.PerPipeline(new MediaConnectRouterPerPipelineSettings {
        Pipeline1 = new MediaConnectRouterPipelineConfig { EncryptionSecret = passphrase1 }
    }),
    Outputs = new [] { new MediaConnectRouterOutputDefinition { Encodes = new [] { video, audio }, OutputName = "router_ts" } }
});
go
// Install: go get github.com/aws/aws-cdk-go/awsmedialivealpha/v2
var video EncodeConfiguration
var audio EncodeConfiguration
var passphrase ISecret
var passphrase1 ISecret


// AUTOMATIC encryption on every pipeline (MPEG-TS container, like UDP)
medialive.OutputGroupConfiguration_MediaConnectRouter(&MediaConnectRouterOutputGroupProps{
	Name: jsii.String("router_out"),
	AvailabilityZones: []*string{
		jsii.String("us-east-1a"),
	},
	Outputs: []MediaConnectRouterOutputDefinition{
		&MediaConnectRouterOutputDefinition{
			Encodes: []EncodeConfiguration{
				video,
				audio,
			},
			OutputName: jsii.String("router_ts"),
		},
	},
})

// One shared Secrets Manager passphrase across all pipelines (SECRETS_MANAGER encryption)
medialive.OutputGroupConfiguration_MediaConnectRouter(&MediaConnectRouterOutputGroupProps{
	Name: jsii.String("router_out"),
	AvailabilityZones: []*string{
		jsii.String("us-east-1a"),
	},
	RouterSettings: medialive.MediaConnectRouterSettings_Shared(&MediaConnectRouterPipelineConfig{
		EncryptionSecret: passphrase,
	}),
	Outputs: []MediaConnectRouterOutputDefinition{
		&MediaConnectRouterOutputDefinition{
			Encodes: []EncodeConfiguration{
				video,
				audio,
			},
			OutputName: jsii.String("router_ts"),
		},
	},
})

// Distinct encryption per pipeline — an omitted pipeline stays AUTOMATIC (STANDARD channels)
medialive.OutputGroupConfiguration_MediaConnectRouter(&MediaConnectRouterOutputGroupProps{
	Name: jsii.String("router_out"),
	AvailabilityZones: []*string{
		jsii.String("us-east-1a"),
		jsii.String("us-east-1b"),
	},
	RouterSettings: medialive.MediaConnectRouterSettings_PerPipeline(&MediaConnectRouterPerPipelineSettings{
		Pipeline1: &MediaConnectRouterPipelineConfig{
			EncryptionSecret: passphrase1,
		},
	}),
	Outputs: []MediaConnectRouterOutputDefinition{
		&MediaConnectRouterOutputDefinition{
			Encodes: []EncodeConfiguration{
				video,
				audio,
			},
			OutputName: jsii.String("router_ts"),
		},
	},
})

Properties ​

availabilityZonesstring[]availability_zonestyping.List[str]availabilityZonesList<String>AvailabilityZonesstring[]AvailabilityZones*[]*string required #
The Availability Zones in which to write output to the MediaConnect Router.

Provide exactly one AZ for a SINGLE_PIPELINE channel, or two (one per pipeline) for a STANDARD channel.

namestringnamestrnameStringNamestringName*string required #
The name of this output group.

Used as the destination reference ID. Underscores are normalised to hyphens internally.

The outputs for this output group.

MediaConnect Router outputs use an MPEG-TS container, so each output may multiplex one video encode and one or more audio encodes (as with UDP).

routerSettingsoptionalMediaConnectRouterSettingsrouter_settingsoptionalMediaConnectRouterSettingsrouterSettingsoptionalMediaConnectRouterSettingsRouterSettingsoptionalMediaConnectRouterSettingsRouterSettingsoptionalMediaConnectRouterSettings #
Transit-encryption settings, applied per channel pipeline.

Default: AUTOMATIC (service-managed) transit encryption on every pipeline