> **Experimental**
>
> `@aws-cdk/aws-mediaconnect-alpha` is an [**experimental**](https://docs.aws.amazon.com/cdk/api/stability.html) (alpha) package: its API may change in any release, without a major version bump.
# FlowProps

Properties for the Flow.

Used as props by: [Flow](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-mediaconnect-alpha.Flow.html)

- Stability: [Experimental](https://docs.aws.amazon.com/cdk/api/stability.html)
- Source: [`lib/flow.ts`](https://github.com/aws/aws-cdk/blob/v2.278.0/packages/@aws-cdk/aws-mediaconnect-alpha/lib/flow.ts#L787)

## Example

TypeScript:

```ts
declare const stack: Stack;
declare const securityGroup: ec2.ISecurityGroup;
declare const subnet: ec2.ISubnet;
declare const role: iam.IRole;

const vpcInterface = VpcInterface.define({
  vpcInterfaceName: 'my-vpc-interface',
  role: role,
  securityGroups: [securityGroup],
  subnet: subnet,
});

const flow = new Flow(stack, 'MyFlow', {
  source: SourceConfiguration.rist({
    flowSourceName: 'vpc-source',
    description: 'VPC-based source',
    port: 5000,
    maxLatency: Duration.millis(2000),
    network: NetworkConfiguration.vpc(vpcInterface),
  }),
  vpcInterfaces: [vpcInterface],
});
```

Python:

```python
# stack: Stack
# security_group: ec2.ISecurityGroup
# subnet: ec2.ISubnet
# role: iam.IRole

vpc_interface = VpcInterface.define(
    vpc_interface_name="my-vpc-interface",
    role=role,
    security_groups=[security_group],
    subnet=subnet
)

flow = Flow(stack, "MyFlow",
    source=SourceConfiguration.rist(
        flow_source_name="vpc-source",
        description="VPC-based source",
        port=5000,
        max_latency=Duration.millis(2000),
        network=NetworkConfiguration.vpc(vpc_interface)
    ),
    vpc_interfaces=[vpc_interface]
)
```

Java:

```java
Stack stack;
ISecurityGroup securityGroup;
ISubnet subnet;
IRole role;

VpcInterfaceConfig vpcInterface = VpcInterface.define(VpcInterfaceDefineProps.builder()
        .vpcInterfaceName("my-vpc-interface")
        .role(role)
        .securityGroups(List.of(securityGroup))
        .subnet(subnet)
        .build());

Flow flow = Flow.Builder.create(stack, "MyFlow")
        .source(SourceConfiguration.rist(SourceRist.builder()
                .flowSourceName("vpc-source")
                .description("VPC-based source")
                .port(5000)
                .maxLatency(Duration.millis(2000))
                .network(NetworkConfiguration.vpc(vpcInterface))
                .build()))
        .vpcInterfaces(List.of(vpcInterface))
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.AWS.MediaConnect.Alpha
Stack stack;
ISecurityGroup securityGroup;
ISubnet subnet;
IRole role;

var vpcInterface = VpcInterface.Define(new VpcInterfaceDefineProps {
    VpcInterfaceName = "my-vpc-interface",
    Role = role,
    SecurityGroups = new [] { securityGroup },
    Subnet = subnet
});

var flow = new Flow(stack, "MyFlow", new FlowProps {
    Source = SourceConfiguration.Rist(new SourceRist {
        FlowSourceName = "vpc-source",
        Description = "VPC-based source",
        Port = 5000,
        MaxLatency = Duration.Millis(2000),
        Network = NetworkConfiguration.Vpc(vpcInterface)
    }),
    VpcInterfaces = new [] { vpcInterface }
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awsmediaconnectalpha/v2
var stack Stack
var securityGroup ISecurityGroup
var subnet ISubnet
var role IRole

vpcInterface := awsmediaconnectalpha.VpcInterface_Define(&VpcInterfaceDefineProps{
	VpcInterfaceName: jsii.String("my-vpc-interface"),
	Role: role,
	SecurityGroups: []ISecurityGroup{
		securityGroup,
	},
	Subnet: subnet,
})

flow := awsmediaconnectalpha.NewFlow(stack, jsii.String("MyFlow"), &FlowProps{
	Source: awsmediaconnectalpha.SourceConfiguration_Rist(&SourceRist{
		FlowSourceName: jsii.String("vpc-source"),
		Description: jsii.String("VPC-based source"),
		Port: jsii.Number(5000),
		MaxLatency: awscdk.Duration_Millis(jsii.Number(2000)),
		Network: awsmediaconnectalpha.NetworkConfiguration_Vpc(vpcInterface),
	}),
	VpcInterfaces: []VpcInterfaceConfig{
		vpcInterface,
	},
})
```

## Properties

- `availabilityZone`: string — The Availability Zone that you want to create the flow in.

  **Default:** chosen by MediaConnect

  These options are limited to the Availability Zones within the current AWS Region.

- `encodingConfig`: [EncodingConfig](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-mediaconnect-alpha.EncodingConfig.html) — Encoding configuration applied to the NDI source when transcoding it to a transport stream for downstream distribution.

  **Default:** no encoding config; required for NDI sources

  Required when the flow source uses the NDI SpeedHQ protocol
  (see {@link SourceConfiguration.ndi}).

- `flowName`: string = autogenerated — The name of the flow.

- `flowSize`: [FlowSize](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-mediaconnect-alpha.FlowSize.html) — Determines the processing capacity and feature set of the flow.

  **Default:** undefined; when omitted, MediaConnect applies FlowSize.MEDIUM at deploy time

  Set this optional parameter to LARGE if you want to enable NDI outputs on the flow.

- `maintenanceConfiguration`: [MaintenanceWindow](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-mediaconnect-alpha.MaintenanceWindow.html) — The maintenance window for the flow.

  **Default:** chosen by MediaConnect

- `mediaStreams`: [MediaStream](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-mediaconnect-alpha.MediaStream.html)[] — The media streams that are associated with the flow.

  **Default:** No Media Streams

  After you associate a media stream with a source, you can also associate it with outputs on the flow.

- `ndiConfig`: [NdiConfig](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-mediaconnect-alpha.NdiConfig.html) — Specifies the configuration settings for a flow's NDI source or output.

  **Default:** No NDI Configuration applied

  Required when the flow includes an NDI source or output.

- `source`: [SourceConfiguration](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-mediaconnect-alpha.SourceConfiguration.html) (required) — The settings for the source that you want to use for the new flow.

- `sourceFailoverConfig`: [FailoverConfig](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-mediaconnect-alpha.FailoverConfig.html) — The settings for source failover.

  **Default:** No source failover configuration applied

- `sourceMonitoringConfig`: [SourceMonitoringConfig](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-mediaconnect-alpha.SourceMonitoringConfig.html) — The settings for source monitoring.

  **Default:** No source monitoring configuration applied

- `vpcInterfaces`: [VpcInterfaceConfig](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-mediaconnect-alpha.VpcInterfaceConfig.html)[] — The VPC Interfaces for this flow.

  **Default:** No VPC Interface configuration applied
