---
title: "POST /v1/bridges"
method: POST
path: "/v1/bridges"
---

# POST /v1/bridges

`POST /v1/bridges`

Creates a new bridge. The request must include one source.

## Request body

- object
  - `egressGatewayBridge` object — Create a bridge with the egress bridge type. An egress bridge is a cloud-to-ground bridge. The content comes from an existing MediaConnect flow and is delivered to your premises.
    - `MaxBitrate` integer — The maximum expected bitrate (in bps).
  - `ingressGatewayBridge` object — Create a bridge with the ingress bridge type. An ingress bridge is a ground-to-cloud bridge. The content originates at your premises and is delivered to the cloud.
    - `MaxBitrate` integer — The maximum expected bitrate (in bps).
    - `MaxOutputs` integer — The maximum number of expected outputs.
  - `name` string, required — The name of the bridge. This name can not be modified after the bridge is created.
  - `outputs` AddBridgeOutputRequest[] — The outputs that you want to add to this bridge.
    - `NetworkOutput` object — Add a network output to an existing bridge.
      - `IpAddress` string, required — The network output IP Address.
      - `Name` string, required — The network output name. This name is used to reference the output and must be unique among outputs in this bridge.
      - `NetworkName` string, required — The network output's gateway network name.
      - `Port` integer, required — The network output port.
      - `Protocol` 'zixi-push' | 'rtp-fec' | 'rtp' | 'zixi-pull' | 'rist' | 'st2110-jpegxs' | 'cdi' | 'srt-listener' | 'srt-caller' | 'fujitsu-qos' | 'udp', required — The network output protocol.
      - `Ttl` integer, required — The network output TTL.
  - `placementArn` string, required — The bridge placement Amazon Resource Number (ARN).
  - `sourceFailoverConfig` object — The settings for source failover.
    - `FailoverMode` 'MERGE' | 'FAILOVER' — The type of failover you choose for this flow. MERGE combines the source streams into a single stream, allowing graceful recovery from any single-source loss. FAILOVER allows switching between different streams.
    - `RecoveryWindow` integer — Search window time to look for dash-7 packets
    - `SourcePriority` object — The priority you want to assign to a source. You can have a primary stream and a backup stream or two equally prioritized streams.
      - `PrimarySource` string — The name of the source you choose as the primary source for this flow.
    - `State` 'ENABLED' | 'DISABLED'
  - `sources` AddBridgeSourceRequest[], required — The sources that you want to add to this bridge.
    - `FlowSource` object — Add a flow source to an existing bridge.
      - `FlowArn` string, required — The Amazon Resource Number (ARN) of the cloud flow to use as a source of this bridge.
      - `FlowVpcInterfaceAttachment` object — The name of the VPC interface attachment to use for this source.
        - `VpcInterfaceName` string — The name of the VPC interface to use for this resource.
      - `Name` string, required — The name of the flow source. This name is used to reference the source and must be unique among sources in this bridge.
    - `NetworkSource` object — Add a network source to an existing bridge.
      - `MulticastIp` string, required — The network source multicast IP.
      - `Name` string, required — The name of the network source. This name is used to reference the source and must be unique among sources in this bridge.
      - `NetworkName` string, required — The network source's gateway network name.
      - `Port` integer, required — The network source port.
      - `Protocol` 'zixi-push' | 'rtp-fec' | 'rtp' | 'zixi-pull' | 'rist' | 'st2110-jpegxs' | 'cdi' | 'srt-listener' | 'srt-caller' | 'fujitsu-qos' | 'udp', required — The network source protocol.

## Response `201`

Success

- CreateBridgeResponse
  - `Bridge` object — A Bridge is the connection between your datacenter's Instances and the AWS cloud. A bridge can be used to send video from the AWS cloud to your datacenter or from your datacenter to the AWS cloud.
    - `BridgeArn` string, required — The Amazon Resource Number (ARN) of the bridge.
    - `BridgeMessages` MessageDetail[]
      - `Code` string, required — The error code.
      - `Message` string, required — The specific error message that MediaConnect returns to help you understand the reason that the request did not succeed.
      - `ResourceName` string — The name of the resource.
    - `BridgeState` 'CREATING' | 'STANDBY' | 'STARTING' | 'DEPLOYING' | 'ACTIVE' | 'STOPPING' | 'DELETING' | 'DELETED' | 'START_FAILED' | 'START_PENDING' | 'STOP_FAILED' | 'UPDATING', required
    - `EgressGatewayBridge` object
      - `InstanceId` string — The ID of the instance running this bridge.
      - `MaxBitrate` integer, required — The maximum expected bitrate (in bps) of the egress bridge.
    - `IngressGatewayBridge` object
      - `InstanceId` string — The ID of the instance running this bridge.
      - `MaxBitrate` integer, required — The maximum expected bitrate (in bps) of the ingress bridge.
      - `MaxOutputs` integer, required — The maximum number of outputs on the ingress bridge.
    - `Name` string, required — The name of the bridge.
    - `Outputs` BridgeOutput[] — The outputs on this bridge.
      - `FlowOutput` object — The output of the bridge. A flow output is delivered to the AWS cloud.
        - `FlowArn` string, required — The Amazon Resource Number (ARN) of the cloud flow.
        - `FlowSourceArn` string, required — The Amazon Resource Number (ARN) of the flow source.
        - `Name` string, required — The name of the bridge's output.
      - `NetworkOutput` object — The output of the bridge. A network output is delivered to your premises.
        - `IpAddress` string, required — The network output IP Address.
        - `Name` string, required — The network output name.
        - `NetworkName` string, required — The network output's gateway network name.
        - `Port` integer, required — The network output port.
        - `Protocol` 'zixi-push' | 'rtp-fec' | 'rtp' | 'zixi-pull' | 'rist' | 'st2110-jpegxs' | 'cdi' | 'srt-listener' | 'srt-caller' | 'fujitsu-qos' | 'udp', required — The network output protocol.
        - `Ttl` integer, required — The network output TTL.
    - `PlacementArn` string, required — The placement Amazon Resource Number (ARN) of the bridge.
    - `SourceFailoverConfig` object — The settings for source failover.
      - `FailoverMode` 'MERGE' | 'FAILOVER' — The type of failover you choose for this flow. MERGE combines the source streams into a single stream, allowing graceful recovery from any single-source loss. FAILOVER allows switching between different streams.
      - `RecoveryWindow` integer — Search window time to look for dash-7 packets
      - `SourcePriority` object — The priority you want to assign to a source. You can have a primary stream and a backup stream or two equally prioritized streams.
        - `PrimarySource` string — The name of the source you choose as the primary source for this flow.
      - `State` 'ENABLED' | 'DISABLED'
    - `Sources` BridgeSource[] — The sources on this bridge.
      - `FlowSource` object — The source of the bridge. A flow source originates in MediaConnect as an existing cloud flow.
        - `FlowArn` string, required — The ARN of the cloud flow used as a source of this bridge.
        - `FlowVpcInterfaceAttachment` object — The name of the VPC interface attachment to use for this source.
          - `VpcInterfaceName` string — The name of the VPC interface to use for this resource.
        - `Name` string, required — The name of the flow source.
        - `OutputArn` string — The Amazon Resource Number (ARN) of the output.
      - `NetworkSource` object — The source of the bridge. A network source originates at your premises.
        - `MulticastIp` string, required — The network source multicast IP.
        - `Name` string, required — The name of the network source.
        - `NetworkName` string, required — The network source's gateway network name.
        - `Port` integer, required — The network source port.
        - `Protocol` 'zixi-push' | 'rtp-fec' | 'rtp' | 'zixi-pull' | 'rist' | 'st2110-jpegxs' | 'cdi' | 'srt-listener' | 'srt-caller' | 'fujitsu-qos' | 'udp', required — The network source protocol.

## Other responses

- `480` — CreateBridge420Exception
- `481` — BadRequestException
- `482` — InternalServerErrorException
- `483` — ForbiddenException
- `484` — ServiceUnavailableException
- `485` — TooManyRequestsException
- `486` — ConflictException

---

[API](https://skmtc.net/aws/apis/mediaconnect.md) · [All operations](https://skmtc.net/aws/apis/mediaconnect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/mediaconnect/versions/695822d698d7/schema)