Creating a transport stream flow that uses a standard source

Transport stream flows transport compressed content that is muxed into a single stream.

A flow uses a standard source when the content comes from anywhere other than a VPC (VPC source) or another AWS account (entitled source).

Important

If the source of your flow requires encryption, set up encryption before you begin this procedure.

To create a transport stream flow that uses a standard source (console)

Open the MediaConnect console at https://console.aws.amazon.com/mediaconnect/.
On the Flows page, choose Create flow.
In the Details section, for Name, specify a name for your flow. This name will become part of the ARN for this flow.

Note
MediaConnect allows you to create multiple flows with the same name. However, we encourage you to use unique flow names within an AWS Region to help with organization. After you create a flow, you can't change the name.
For Availability Zone, choose an Availability Zone for your flow. Use this option when you are setting up redundant flows. Otherwise, you can leave this as Any. If you leave the default, the service will randomly assign an Availability Zone within the current AWS Region, or if your source comes from a VPC, the service will assign the Availability Zone of the VPC subnet to the flow.
Determine which protocol your source uses.

Note
If you want to specify redundant sources for failover, create the flow with one of the sources. After the flow is created, update it to enable failover on the source, and add the second source to the flow. Because MediaConnect treats both sources as the primary source, it doesn't matter which one you specify when you first create the flow.
For specific instructions based on your source type and protocol, choose one of the following tabs:
RIST
In the Source section, for Source type, choose Standard source.

For Name, specify a name for your source. This value is an identifier that is visible only on the MediaConnect console.

For Protocol, choose RIST.

For Ingest port, specify the port that the flow will listen on for incoming content.

Note
The RIST protocol requires one additional port for error correction. To accommodate this requirement, MediaConnect reserves the port that is +1 from the port that you specify. For example, if you specify port 4000 for the output, the service assigns ports 4000 and 4001.

For Whitelist CIDR, specify a range of IP addresses that are allowed to contribute content to your source. Format the IP addresses as a Classless Inter-Domain Routing (CIDR) block, for example, 10.24.34.0/23. For more information about CIDR notation, see RFC 4632.

Important
Specify a CIDR block that is as precise as possible. Include only the IP addresses that you want to contribute content to your flow. If you specify a CIDR block that is too wide, it allows for the possibility of outside parties sending content to your flow.

For Maximum bitrate, specify the maximum expected bitrate (in bits per second) for the flow. We recommend that you specify a value that is twice the actual bitrate.

For Maximum latency, specify the size of the buffer (delay) that you want the service to maintain. A higher latency value means a longer delay in transmitting the stream, but more room for error correction. A lower latency value means a shorter delay, but less room for error correction. You can choose a value from 1-15,000 ms. If you keep this field blank, the service uses the default value of 2,000 ms.
RTP or RTP-FEC
In the Source section, for Source type, choose Standard source.

For Name, specify a name for your source. This value is an identifier that is visible only on the MediaConnect console. It is not visible to anyone outside of the current AWS account.

For Protocol, choose RTP or RTP-FEC.

For Ingest port, specify the port that the flow will listen on for incoming content.

Note
The RTP-FEC protocol requires two additional ports for error correction. To accommodate this requirement, MediaConnect reserves the ports that are +2 and +4 from the port that you specify. For example, if you specify port 4000 for the output, the service assigns ports 4000, 4002, and 4004.

For Whitelist CIDR, specify a range of IP addresses that are allowed to contribute content to your source. Format the IP addresses as a Classless Inter-Domain Routing (CIDR) block, for example, 10.24.34.0/23. For more information about CIDR notation, see RFC 4632.

Important
Specify a CIDR block that is as precise as possible. Include only the IP addresses that you want to contribute content to your flow. If you specify a CIDR block that is too wide, it allows for the possibility of outside parties sending content to your flow.

For Maximum bitrate, specify the maximum expected bitrate (in bits per second) for the flow. We recommend that you specify a value that is twice the actual bitrate.
SRT listener
In the Source section, for Source type, choose Standard source.

For Inbound port, specify the port that the flow listens on for incoming content.

For Whitelist CIDR, specify a range of IP addresses that are allowed to contribute content to your source. Format the IP addresses as a Classless Inter-Domain Routing (CIDR) block, for example, 10.24.34.0/23. For more information about CIDR notation, see RFC 4632.

Important
Specify a CIDR block that is as precise as possible. Include only the IP addresses that you want to contribute content to your flow. If you specify a CIDR block that is too wide, it allows for the possibility of outside parties sending content to your flow.

For Source description, enter a description that will remind you later where this source is from. This might be the company name or notes about the setup.

For Maximum bitrate, specify the maximum expected bitrate (in bits per second) for the flow. We recommend that you specify a value that is twice the actual bitrate.

For Minimum latency, specify the minimum size of the buffer (delay) that you want the service to maintain. A higher latency value means a longer delay in transmitting the stream, but more room for error correction. A lower latency value means a shorter delay, but less room for error correction. You can choose a value from 100–15,000 ms. If you keep this field blank, MediaConnect uses the default value of 2,000 ms.

If the source is encrypted, choose Enable in the Decryption section and do the following:

For Role ARN, specify the ARN of the role that you created when you set up encryption.

For Secret ARN, specify the ARN that AWS Secrets Manager assigned when you created the secret to store the encryption key.
SRT caller
In the Source section, for Source type, choose Standard source.

For Name, specify a name for your source. This value is an identifier that is visible only on the MediaConnect console. It is not visible to anyone outside of the current AWS account.

For Protocol, choose SRT caller.

For Source description, enter a description that will remind you later where this source is from. This might be the company name or notes about the setup.

For Source listener address, enter the address MediaConnect will use for the SRT connection. The address can be an IP address or a domain name.

For Source listener port, enter the port MediaConnect will use for the SRT connection..

For Maximum bitrate (optional), specify the maximum expected bitrate (in bits per second) for the flow. We recommend that you specify a value that is twice the actual bitrate.

For Minimum latency, specify the minimum size of the buffer (delay) that you want the service to maintain. A higher latency value means a longer delay in transmitting the stream, but more room for error correction. A lower latency value means a shorter delay, but less room for error correction. You can choose a value from 100–15,000 ms. If you keep this field blank, MediaConnect uses the default value of 2,000 ms.

For Stream ID (optional), enter an identifier for the stream. This identifier can be used to communicate information about the stream.

If the source is encrypted, choose Enable in the Decryption section and do the following:

For Role ARN, specify the ARN of the role that you created when you set up encryption.

For Secret ARN, specify the ARN that AWS Secrets Manager assigned when you created the secret to store the encryption key.
Zixi push
In the Source section, for Source type, choose Standard source.

For Name, specify a name for your source. This value is an identifier that is visible only on the MediaConnect console. It is not visible to anyone outside of the current AWS account.

For Protocol, choose Zixi push.

Note
MediaConnect assigns the inbound port for Zixi push sources at the time of creation. A port number of 2088 will be assigned automatically.

For Whitelist CIDR, specify a range of IP addresses that are allowed to contribute content to your source. Format the IP addresses as a Classless Inter-Domain Routing (CIDR) block, for example, 10.24.34.0/23. For more information about CIDR notation, see RFC 4632.

Important
Specify a CIDR block that is as precise as possible. Include only the IP addresses that you want to contribute content to your flow. If you specify a CIDR block that is too wide, it allows for the possibility of outside parties sending content to your flow.

For Stream ID, specify the stream ID set in the Zixi feeder.

Important
If you leave this field blank, the service uses the source name as the stream ID. Because the stream ID must match the value set in the Zixi feeder, you need to specify the stream ID if it is not exactly the same as the source name.

For Maximum latency, specify the size of the buffer (delay) that you want the service to maintain. A higher latency value means a longer delay in transmitting the stream, but more room for error correction. A lower latency value means a shorter delay, but less room for error correction. You can choose a value between 0 and 60,000 ms. If you keep this field blank, the service uses the default value of 6,000 ms.

If the source is encrypted, choose Enable in the Decryption section and do the following:

For Decryption type, choose Static key.

For Role ARN, specify the ARN of the role that you created when you set up encryption.

For Secret ARN, specify the ARN that AWS Secrets Manager assigned when you created the secret to store the encryption key.

For Decryption algorithm, choose the type of encryption that was used to encrypt the source.
Fujitsu-QoS
In the Source section, for Source type, choose Standard source.

For Inbound port, specify the port that the flow listens on for incoming content.

For Source description, enter a description that will remind you later where this source is from. This might be the company name or notes about the setup.

For Sender IP address, specify the sender's IP address that you want the flow to make connection with. The flow communicates with the specified IP address to initiate connection with the sender.

For Sender control port, specify the port that the flow uses to send outbound requests to initiate connection with the sender.

For Maximum latency, specify the size of the buffer (delay) that you want the service to maintain. A higher latency value means a longer delay in transmitting the stream, but more room for error correction. A lower latency value means a shorter delay, but less room for error correction. You can choose a value from 300–2,000 ms. If you keep this field blank, MediaConnect uses the default value of 2,000 ms.
At the bottom of the page, choose Create flow.

Note
The flow doesn't start automatically. You must start the flow manually.
Add outputs to specify where you want MediaConnect to send the content, or grant entitlements to allow users of other AWS accounts to subscribe to your content.

To create a flow (AWS CLI)

Create a JSON file that contains the details of the flow that you want to create.

The following example shows the structure for the contents of the file:


{
  "Name": "AwardsShow",
  "Outputs": [
    {
      "Destination": "198.51.100.5",
      "Description": "RTP output",
      "Name": "RTPOutput",
      "Protocol": "rtp",
      "Port": 5020
    }
  ],
  "Source": {
    "Name": "AwardsShowSource",
    "Protocol": "rtp-fec",
    "WhitelistCidr": "10.24.34.0/23"
  }
}

In the AWS CLI, use the create-flow command:


aws mediaconnect create-flow --cli-input-json file://rtp.json --profile PMprofile

The following example shows the return value:


{
  "Flow": {
    "EgressIp": "203.0.113.0",
    "AvailabilityZone": "us-east-1d",
    "Name": "AwardsShow",
    "Status": "STANDBY",
    "FlowArn": "arn:aws:mediaconnect:us-east-1:111122223333:flow:1-23aBC45dEF67hiJ8-12AbC34DE5fG:AwardsShow",
    "Source": {
            "SourceArn": "arn:aws:mediaconnect:us-east-1:111122223333:source:3-4aBC56dEF78hiJ90-4de5fG6Hi78Jk:AwardsShowSource",                                       
            "Name": "AwardsShowSource",
            "IngestPort": 5000,
            "WhitelistCidr": "10.24.34.0/23",
            "IngestIp": "198.51.100.15",
            "Transport": {
                "Protocol": "rtp-fec",
                "MaxBitrate": 80000000
            }
        },
        "Entitlements": [],
        "Outputs": [
            {
                "Port": 5020,
                "Name": "AwardsShowOutput",
                "OutputArn": "arn:aws:mediaconnect:us-east-1:111122223333:output:2-3aBC45dEF67hiJ89-c34de5fG678h:AwardsShowOutput",                                          
                "Description": "RTP-FEC Output",
                "Destination": "198.51.100.5",
                "Transport": {
                    "Protocol": "rtp",
                    "SmoothingLatency": 0
                }
            }
        ]
    }
}

Warning Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Document Conventions

Creating a flow

Transport stream flow, entitled source