# Actions
<a name="API_Operations"></a>

The following actions are supported:
+  [AddBridgeOutputs](API_AddBridgeOutputs.md) 
+  [AddBridgeSources](API_AddBridgeSources.md) 
+  [AddFlowMediaStreams](API_AddFlowMediaStreams.md) 
+  [AddFlowOutputs](API_AddFlowOutputs.md) 
+  [AddFlowSources](API_AddFlowSources.md) 
+  [AddFlowVpcInterfaces](API_AddFlowVpcInterfaces.md) 
+  [BatchGetRouterInput](API_BatchGetRouterInput.md) 
+  [BatchGetRouterNetworkInterface](API_BatchGetRouterNetworkInterface.md) 
+  [BatchGetRouterOutput](API_BatchGetRouterOutput.md) 
+  [CreateBridge](API_CreateBridge.md) 
+  [CreateFlow](API_CreateFlow.md) 
+  [CreateGateway](API_CreateGateway.md) 
+  [CreateRouterInput](API_CreateRouterInput.md) 
+  [CreateRouterNetworkInterface](API_CreateRouterNetworkInterface.md) 
+  [CreateRouterOutput](API_CreateRouterOutput.md) 
+  [DeleteBridge](API_DeleteBridge.md) 
+  [DeleteFlow](API_DeleteFlow.md) 
+  [DeleteGateway](API_DeleteGateway.md) 
+  [DeleteRouterInput](API_DeleteRouterInput.md) 
+  [DeleteRouterNetworkInterface](API_DeleteRouterNetworkInterface.md) 
+  [DeleteRouterOutput](API_DeleteRouterOutput.md) 
+  [DeregisterGatewayInstance](API_DeregisterGatewayInstance.md) 
+  [DescribeBridge](API_DescribeBridge.md) 
+  [DescribeFlow](API_DescribeFlow.md) 
+  [DescribeFlowSourceMetadata](API_DescribeFlowSourceMetadata.md) 
+  [DescribeFlowSourceThumbnail](API_DescribeFlowSourceThumbnail.md) 
+  [DescribeGateway](API_DescribeGateway.md) 
+  [DescribeGatewayInstance](API_DescribeGatewayInstance.md) 
+  [DescribeOffering](API_DescribeOffering.md) 
+  [DescribeReservation](API_DescribeReservation.md) 
+  [GetRouterInput](API_GetRouterInput.md) 
+  [GetRouterInputSourceMetadata](API_GetRouterInputSourceMetadata.md) 
+  [GetRouterInputThumbnail](API_GetRouterInputThumbnail.md) 
+  [GetRouterNetworkInterface](API_GetRouterNetworkInterface.md) 
+  [GetRouterOutput](API_GetRouterOutput.md) 
+  [GrantFlowEntitlements](API_GrantFlowEntitlements.md) 
+  [ListBridges](API_ListBridges.md) 
+  [ListEntitlements](API_ListEntitlements.md) 
+  [ListFlows](API_ListFlows.md) 
+  [ListGatewayInstances](API_ListGatewayInstances.md) 
+  [ListGateways](API_ListGateways.md) 
+  [ListOfferings](API_ListOfferings.md) 
+  [ListReservations](API_ListReservations.md) 
+  [ListRouterInputs](API_ListRouterInputs.md) 
+  [ListRouterNetworkInterfaces](API_ListRouterNetworkInterfaces.md) 
+  [ListRouterOutputs](API_ListRouterOutputs.md) 
+  [ListTagsForGlobalResource](API_ListTagsForGlobalResource.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [PurchaseOffering](API_PurchaseOffering.md) 
+  [RemoveBridgeOutput](API_RemoveBridgeOutput.md) 
+  [RemoveBridgeSource](API_RemoveBridgeSource.md) 
+  [RemoveFlowMediaStream](API_RemoveFlowMediaStream.md) 
+  [RemoveFlowOutput](API_RemoveFlowOutput.md) 
+  [RemoveFlowSource](API_RemoveFlowSource.md) 
+  [RemoveFlowVpcInterface](API_RemoveFlowVpcInterface.md) 
+  [RestartRouterInput](API_RestartRouterInput.md) 
+  [RestartRouterOutput](API_RestartRouterOutput.md) 
+  [RevokeFlowEntitlement](API_RevokeFlowEntitlement.md) 
+  [StartFlow](API_StartFlow.md) 
+  [StartRouterInput](API_StartRouterInput.md) 
+  [StartRouterOutput](API_StartRouterOutput.md) 
+  [StopFlow](API_StopFlow.md) 
+  [StopRouterInput](API_StopRouterInput.md) 
+  [StopRouterOutput](API_StopRouterOutput.md) 
+  [TagGlobalResource](API_TagGlobalResource.md) 
+  [TagResource](API_TagResource.md) 
+  [TakeRouterInput](API_TakeRouterInput.md) 
+  [UntagGlobalResource](API_UntagGlobalResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateBridge](API_UpdateBridge.md) 
+  [UpdateBridgeOutput](API_UpdateBridgeOutput.md) 
+  [UpdateBridgeSource](API_UpdateBridgeSource.md) 
+  [UpdateBridgeState](API_UpdateBridgeState.md) 
+  [UpdateFlow](API_UpdateFlow.md) 
+  [UpdateFlowEntitlement](API_UpdateFlowEntitlement.md) 
+  [UpdateFlowMediaStream](API_UpdateFlowMediaStream.md) 
+  [UpdateFlowOutput](API_UpdateFlowOutput.md) 
+  [UpdateFlowSource](API_UpdateFlowSource.md) 
+  [UpdateGatewayInstance](API_UpdateGatewayInstance.md) 
+  [UpdateRouterInput](API_UpdateRouterInput.md) 
+  [UpdateRouterNetworkInterface](API_UpdateRouterNetworkInterface.md) 
+  [UpdateRouterOutput](API_UpdateRouterOutput.md) 

# AddBridgeOutputs
<a name="API_AddBridgeOutputs"></a>

 Adds outputs to an existing bridge.

## Request Syntax
<a name="API_AddBridgeOutputs_RequestSyntax"></a>

```
POST /v1/bridges/bridgeArn/outputs HTTP/1.1
Content-type: application/json

{
   "outputs": [ 
      { 
         "networkOutput": { 
            "ipAddress": "string",
            "name": "string",
            "networkName": "string",
            "port": number,
            "protocol": "string",
            "ttl": number
         }
      }
   ]
}
```

## URI Request Parameters
<a name="API_AddBridgeOutputs_RequestParameters"></a>

The request uses the following URI parameters.

 ** [bridgeArn](#API_AddBridgeOutputs_RequestSyntax) **   <a name="mediaconnect-AddBridgeOutputs-request-uri-bridgeArn"></a>
 The Amazon Resource Name (ARN) of the bridge that you want to update.  
Pattern: `arn:.+:mediaconnect.+:bridge:.+`   
Required: Yes

## Request Body
<a name="API_AddBridgeOutputs_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [outputs](#API_AddBridgeOutputs_RequestSyntax) **   <a name="mediaconnect-AddBridgeOutputs-request-outputs"></a>
 The outputs that you want to add to this bridge.  
Type: Array of [AddBridgeOutputRequest](API_AddBridgeOutputRequest.md) objects  
Required: Yes

## Response Syntax
<a name="API_AddBridgeOutputs_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "bridgeArn": "string",
   "outputs": [ 
      { 
         "flowOutput": { 
            "flowArn": "string",
            "flowSourceArn": "string",
            "name": "string"
         },
         "networkOutput": { 
            "ipAddress": "string",
            "name": "string",
            "networkName": "string",
            "port": number,
            "protocol": "string",
            "ttl": number
         }
      }
   ]
}
```

## Response Elements
<a name="API_AddBridgeOutputs_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [bridgeArn](#API_AddBridgeOutputs_ResponseSyntax) **   <a name="mediaconnect-AddBridgeOutputs-response-bridgeArn"></a>
 The ARN of the bridge that you added outputs to.  
Type: String

 ** [outputs](#API_AddBridgeOutputs_ResponseSyntax) **   <a name="mediaconnect-AddBridgeOutputs-response-outputs"></a>
 The outputs that you added to this bridge.  
Type: Array of [BridgeOutput](API_BridgeOutput.md) objects

## Errors
<a name="API_AddBridgeOutputs_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_AddBridgeOutputs_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/AddBridgeOutputs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/AddBridgeOutputs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/AddBridgeOutputs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/AddBridgeOutputs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/AddBridgeOutputs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/AddBridgeOutputs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/AddBridgeOutputs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/AddBridgeOutputs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/AddBridgeOutputs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/AddBridgeOutputs) 

# AddBridgeSources
<a name="API_AddBridgeSources"></a>

 Adds sources to an existing bridge.

## Request Syntax
<a name="API_AddBridgeSources_RequestSyntax"></a>

```
POST /v1/bridges/bridgeArn/sources HTTP/1.1
Content-type: application/json

{
   "sources": [ 
      { 
         "flowSource": { 
            "flowArn": "string",
            "flowVpcInterfaceAttachment": { 
               "vpcInterfaceName": "string"
            },
            "name": "string"
         },
         "networkSource": { 
            "multicastIp": "string",
            "multicastSourceSettings": { 
               "multicastSourceIp": "string"
            },
            "name": "string",
            "networkName": "string",
            "port": number,
            "protocol": "string"
         }
      }
   ]
}
```

## URI Request Parameters
<a name="API_AddBridgeSources_RequestParameters"></a>

The request uses the following URI parameters.

 ** [bridgeArn](#API_AddBridgeSources_RequestSyntax) **   <a name="mediaconnect-AddBridgeSources-request-uri-bridgeArn"></a>
 The Amazon Resource Name (ARN) of the bridge that you want to update.  
Required: Yes

## Request Body
<a name="API_AddBridgeSources_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [sources](#API_AddBridgeSources_RequestSyntax) **   <a name="mediaconnect-AddBridgeSources-request-sources"></a>
 The sources that you want to add to this bridge.  
Type: Array of [AddBridgeSourceRequest](API_AddBridgeSourceRequest.md) objects  
Required: Yes

## Response Syntax
<a name="API_AddBridgeSources_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "bridgeArn": "string",
   "sources": [ 
      { 
         "flowSource": { 
            "flowArn": "string",
            "flowVpcInterfaceAttachment": { 
               "vpcInterfaceName": "string"
            },
            "name": "string",
            "outputArn": "string"
         },
         "networkSource": { 
            "multicastIp": "string",
            "multicastSourceSettings": { 
               "multicastSourceIp": "string"
            },
            "name": "string",
            "networkName": "string",
            "port": number,
            "protocol": "string"
         }
      }
   ]
}
```

## Response Elements
<a name="API_AddBridgeSources_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [bridgeArn](#API_AddBridgeSources_ResponseSyntax) **   <a name="mediaconnect-AddBridgeSources-response-bridgeArn"></a>
 The ARN of the bridge that you added sources to.  
Type: String

 ** [sources](#API_AddBridgeSources_ResponseSyntax) **   <a name="mediaconnect-AddBridgeSources-response-sources"></a>
 The sources that you added to this bridge.  
Type: Array of [BridgeSource](API_BridgeSource.md) objects

## Errors
<a name="API_AddBridgeSources_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_AddBridgeSources_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/AddBridgeSources) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/AddBridgeSources) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/AddBridgeSources) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/AddBridgeSources) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/AddBridgeSources) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/AddBridgeSources) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/AddBridgeSources) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/AddBridgeSources) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/AddBridgeSources) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/AddBridgeSources) 

# AddFlowMediaStreams
<a name="API_AddFlowMediaStreams"></a>

 Adds media streams to an existing flow. After you add a media stream to a flow, you can associate it with a source and/or an output that uses the ST 2110 JPEG XS or CDI protocol.

## Request Syntax
<a name="API_AddFlowMediaStreams_RequestSyntax"></a>

```
POST /v1/flows/flowArn/mediaStreams HTTP/1.1
Content-type: application/json

{
   "mediaStreams": [ 
      { 
         "attributes": { 
            "fmtp": { 
               "channelOrder": "string",
               "colorimetry": "string",
               "exactFramerate": "string",
               "par": "string",
               "range": "string",
               "scanMode": "string",
               "tcs": "string"
            },
            "lang": "string"
         },
         "clockRate": number,
         "description": "string",
         "mediaStreamId": number,
         "mediaStreamName": "string",
         "mediaStreamTags": { 
            "string" : "string" 
         },
         "mediaStreamType": "string",
         "videoFormat": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_AddFlowMediaStreams_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_AddFlowMediaStreams_RequestSyntax) **   <a name="mediaconnect-AddFlowMediaStreams-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

## Request Body
<a name="API_AddFlowMediaStreams_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [mediaStreams](#API_AddFlowMediaStreams_RequestSyntax) **   <a name="mediaconnect-AddFlowMediaStreams-request-mediaStreams"></a>
 The media streams that you want to add to the flow.  
Type: Array of [AddMediaStreamRequest](API_AddMediaStreamRequest.md) objects  
Required: Yes

## Response Syntax
<a name="API_AddFlowMediaStreams_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "flowArn": "string",
   "mediaStreams": [ 
      { 
         "attributes": { 
            "fmtp": { 
               "channelOrder": "string",
               "colorimetry": "string",
               "exactFramerate": "string",
               "par": "string",
               "range": "string",
               "scanMode": "string",
               "tcs": "string"
            },
            "lang": "string"
         },
         "clockRate": number,
         "description": "string",
         "fmt": number,
         "mediaStreamId": number,
         "mediaStreamName": "string",
         "mediaStreamType": "string",
         "videoFormat": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AddFlowMediaStreams_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_AddFlowMediaStreams_ResponseSyntax) **   <a name="mediaconnect-AddFlowMediaStreams-response-flowArn"></a>
 The ARN of the flow that you added media streams to.  
Type: String

 ** [mediaStreams](#API_AddFlowMediaStreams_ResponseSyntax) **   <a name="mediaconnect-AddFlowMediaStreams-response-mediaStreams"></a>
 The media streams that you added to the flow.  
Type: Array of [MediaStream](API_MediaStream.md) objects

## Errors
<a name="API_AddFlowMediaStreams_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_AddFlowMediaStreams_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/AddFlowMediaStreams) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/AddFlowMediaStreams) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/AddFlowMediaStreams) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/AddFlowMediaStreams) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/AddFlowMediaStreams) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/AddFlowMediaStreams) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/AddFlowMediaStreams) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/AddFlowMediaStreams) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/AddFlowMediaStreams) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/AddFlowMediaStreams) 

# AddFlowOutputs
<a name="API_AddFlowOutputs"></a>

 Adds outputs to an existing flow. You can create up to 50 outputs per flow.

## Request Syntax
<a name="API_AddFlowOutputs_RequestSyntax"></a>

```
POST /v1/flows/flowArn/outputs HTTP/1.1
Content-type: application/json

{
   "outputs": [ 
      { 
         "cidrAllowList": [ "string" ],
         "description": "string",
         "destination": "string",
         "encryption": { 
            "algorithm": "string",
            "constantInitializationVector": "string",
            "deviceId": "string",
            "keyType": "string",
            "region": "string",
            "resourceId": "string",
            "roleArn": "string",
            "secretArn": "string",
            "url": "string"
         },
         "maxLatency": number,
         "mediaStreamOutputConfigurations": [ 
            { 
               "destinationConfigurations": [ 
                  { 
                     "destinationIp": "string",
                     "destinationPort": number,
                     "interface": { 
                        "name": "string"
                     }
                  }
               ],
               "encodingName": "string",
               "encodingParameters": { 
                  "compressionFactor": number,
                  "encoderProfile": "string"
               },
               "mediaStreamName": "string"
            }
         ],
         "minLatency": number,
         "name": "string",
         "ndiProgramName": "string",
         "ndiSpeedHqQuality": number,
         "outputStatus": "string",
         "outputTags": { 
            "string" : "string" 
         },
         "port": number,
         "protocol": "string",
         "remoteId": "string",
         "routerIntegrationState": "string",
         "routerIntegrationTransitEncryption": { 
            "encryptionKeyConfiguration": { ... },
            "encryptionKeyType": "string"
         },
         "senderControlPort": number,
         "smoothingLatency": number,
         "streamId": "string",
         "vpcInterfaceAttachment": { 
            "vpcInterfaceName": "string"
         }
      }
   ]
}
```

## URI Request Parameters
<a name="API_AddFlowOutputs_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_AddFlowOutputs_RequestSyntax) **   <a name="mediaconnect-AddFlowOutputs-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that you want to add outputs to.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

## Request Body
<a name="API_AddFlowOutputs_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [outputs](#API_AddFlowOutputs_RequestSyntax) **   <a name="mediaconnect-AddFlowOutputs-request-outputs"></a>
 A list of outputs that you want to add to the flow.  
Type: Array of [AddOutputRequest](API_AddOutputRequest.md) objects  
Required: Yes

## Response Syntax
<a name="API_AddFlowOutputs_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "flowArn": "string",
   "outputs": [ 
      { 
         "bridgeArn": "string",
         "bridgePorts": [ number ],
         "connectedRouterInputArn": "string",
         "dataTransferSubscriberFeePercent": number,
         "description": "string",
         "destination": "string",
         "encryption": { 
            "algorithm": "string",
            "constantInitializationVector": "string",
            "deviceId": "string",
            "keyType": "string",
            "region": "string",
            "resourceId": "string",
            "roleArn": "string",
            "secretArn": "string",
            "url": "string"
         },
         "entitlementArn": "string",
         "listenerAddress": "string",
         "mediaLiveInputArn": "string",
         "mediaStreamOutputConfigurations": [ 
            { 
               "destinationConfigurations": [ 
                  { 
                     "destinationIp": "string",
                     "destinationPort": number,
                     "interface": { 
                        "name": "string"
                     },
                     "outboundIp": "string"
                  }
               ],
               "encodingName": "string",
               "encodingParameters": { 
                  "compressionFactor": number,
                  "encoderProfile": "string"
               },
               "mediaStreamName": "string"
            }
         ],
         "name": "string",
         "outputArn": "string",
         "outputStatus": "string",
         "peerIpAddress": "string",
         "port": number,
         "routerIntegrationState": "string",
         "routerIntegrationTransitEncryption": { 
            "encryptionKeyConfiguration": { ... },
            "encryptionKeyType": "string"
         },
         "transport": { 
            "cidrAllowList": [ "string" ],
            "maxBitrate": number,
            "maxLatency": number,
            "maxSyncBuffer": number,
            "minLatency": number,
            "ndiProgramName": "string",
            "ndiSourceSettings": { 
               "sourceName": "string"
            },
            "ndiSpeedHqQuality": number,
            "protocol": "string",
            "remoteId": "string",
            "senderControlPort": number,
            "senderIpAddress": "string",
            "smoothingLatency": number,
            "sourceListenerAddress": "string",
            "sourceListenerPort": number,
            "streamId": "string"
         },
         "vpcInterfaceAttachment": { 
            "vpcInterfaceName": "string"
         }
      }
   ]
}
```

## Response Elements
<a name="API_AddFlowOutputs_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_AddFlowOutputs_ResponseSyntax) **   <a name="mediaconnect-AddFlowOutputs-response-flowArn"></a>
 The ARN of the flow that these outputs were added to.  
Type: String

 ** [outputs](#API_AddFlowOutputs_ResponseSyntax) **   <a name="mediaconnect-AddFlowOutputs-response-outputs"></a>
 The details of the newly added outputs.  
Type: Array of [Output](API_Output.md) objects

## Errors
<a name="API_AddFlowOutputs_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AddFlowOutputs420Exception **   
Exception raised by AWS Elemental MediaConnect when adding the flow output. See the error message for the operation for more information on the cause of this exception.   
HTTP Status Code: 420

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_AddFlowOutputs_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/AddFlowOutputs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/AddFlowOutputs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/AddFlowOutputs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/AddFlowOutputs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/AddFlowOutputs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/AddFlowOutputs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/AddFlowOutputs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/AddFlowOutputs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/AddFlowOutputs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/AddFlowOutputs) 

# AddFlowSources
<a name="API_AddFlowSources"></a>

 Adds sources to a flow.

## Request Syntax
<a name="API_AddFlowSources_RequestSyntax"></a>

```
POST /v1/flows/flowArn/source HTTP/1.1
Content-type: application/json

{
   "sources": [ 
      { 
         "decryption": { 
            "algorithm": "string",
            "constantInitializationVector": "string",
            "deviceId": "string",
            "keyType": "string",
            "region": "string",
            "resourceId": "string",
            "roleArn": "string",
            "secretArn": "string",
            "url": "string"
         },
         "description": "string",
         "entitlementArn": "string",
         "gatewayBridgeSource": { 
            "bridgeArn": "string",
            "vpcInterfaceAttachment": { 
               "vpcInterfaceName": "string"
            }
         },
         "ingestPort": number,
         "maxBitrate": number,
         "maxLatency": number,
         "maxSyncBuffer": number,
         "mediaStreamSourceConfigurations": [ 
            { 
               "encodingName": "string",
               "inputConfigurations": [ 
                  { 
                     "inputPort": number,
                     "interface": { 
                        "name": "string"
                     }
                  }
               ],
               "mediaStreamName": "string"
            }
         ],
         "minLatency": number,
         "name": "string",
         "ndiSourceSettings": { 
            "sourceName": "string"
         },
         "protocol": "string",
         "routerIntegrationState": "string",
         "routerIntegrationTransitDecryption": { 
            "encryptionKeyConfiguration": { ... },
            "encryptionKeyType": "string"
         },
         "senderControlPort": number,
         "senderIpAddress": "string",
         "sourceListenerAddress": "string",
         "sourceListenerPort": number,
         "sourceTags": { 
            "string" : "string" 
         },
         "streamId": "string",
         "vpcInterfaceName": "string",
         "whitelistCidr": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_AddFlowSources_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_AddFlowSources_RequestSyntax) **   <a name="mediaconnect-AddFlowSources-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that you want to update.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

## Request Body
<a name="API_AddFlowSources_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [sources](#API_AddFlowSources_RequestSyntax) **   <a name="mediaconnect-AddFlowSources-request-sources"></a>
 A list of sources that you want to add to the flow.  
Type: Array of [SetSourceRequest](API_SetSourceRequest.md) objects  
Required: Yes

## Response Syntax
<a name="API_AddFlowSources_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "flowArn": "string",
   "sources": [ 
      { 
         "connectedRouterOutputArn": "string",
         "dataTransferSubscriberFeePercent": number,
         "decryption": { 
            "algorithm": "string",
            "constantInitializationVector": "string",
            "deviceId": "string",
            "keyType": "string",
            "region": "string",
            "resourceId": "string",
            "roleArn": "string",
            "secretArn": "string",
            "url": "string"
         },
         "description": "string",
         "entitlementArn": "string",
         "gatewayBridgeSource": { 
            "bridgeArn": "string",
            "vpcInterfaceAttachment": { 
               "vpcInterfaceName": "string"
            }
         },
         "ingestIp": "string",
         "ingestPort": number,
         "mediaStreamSourceConfigurations": [ 
            { 
               "encodingName": "string",
               "inputConfigurations": [ 
                  { 
                     "inputIp": "string",
                     "inputPort": number,
                     "interface": { 
                        "name": "string"
                     }
                  }
               ],
               "mediaStreamName": "string"
            }
         ],
         "name": "string",
         "peerIpAddress": "string",
         "routerIntegrationState": "string",
         "routerIntegrationTransitDecryption": { 
            "encryptionKeyConfiguration": { ... },
            "encryptionKeyType": "string"
         },
         "senderControlPort": number,
         "senderIpAddress": "string",
         "sourceArn": "string",
         "transport": { 
            "cidrAllowList": [ "string" ],
            "maxBitrate": number,
            "maxLatency": number,
            "maxSyncBuffer": number,
            "minLatency": number,
            "ndiProgramName": "string",
            "ndiSourceSettings": { 
               "sourceName": "string"
            },
            "ndiSpeedHqQuality": number,
            "protocol": "string",
            "remoteId": "string",
            "senderControlPort": number,
            "senderIpAddress": "string",
            "smoothingLatency": number,
            "sourceListenerAddress": "string",
            "sourceListenerPort": number,
            "streamId": "string"
         },
         "vpcInterfaceName": "string",
         "whitelistCidr": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AddFlowSources_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_AddFlowSources_ResponseSyntax) **   <a name="mediaconnect-AddFlowSources-response-flowArn"></a>
 The ARN of the flow that these sources were added to.  
Type: String

 ** [sources](#API_AddFlowSources_ResponseSyntax) **   <a name="mediaconnect-AddFlowSources-response-sources"></a>
 The details of the newly added sources.  
Type: Array of [Source](API_Source.md) objects

## Errors
<a name="API_AddFlowSources_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_AddFlowSources_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/AddFlowSources) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/AddFlowSources) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/AddFlowSources) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/AddFlowSources) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/AddFlowSources) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/AddFlowSources) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/AddFlowSources) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/AddFlowSources) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/AddFlowSources) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/AddFlowSources) 

# AddFlowVpcInterfaces
<a name="API_AddFlowVpcInterfaces"></a>

 Adds VPC interfaces to a flow.

## Request Syntax
<a name="API_AddFlowVpcInterfaces_RequestSyntax"></a>

```
POST /v1/flows/flowArn/vpcInterfaces HTTP/1.1
Content-type: application/json

{
   "vpcInterfaces": [ 
      { 
         "name": "string",
         "networkInterfaceType": "string",
         "roleArn": "string",
         "securityGroupIds": [ "string" ],
         "subnetId": "string",
         "vpcInterfaceTags": { 
            "string" : "string" 
         }
      }
   ]
}
```

## URI Request Parameters
<a name="API_AddFlowVpcInterfaces_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_AddFlowVpcInterfaces_RequestSyntax) **   <a name="mediaconnect-AddFlowVpcInterfaces-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that you want to update.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

## Request Body
<a name="API_AddFlowVpcInterfaces_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [vpcInterfaces](#API_AddFlowVpcInterfaces_RequestSyntax) **   <a name="mediaconnect-AddFlowVpcInterfaces-request-vpcInterfaces"></a>
 A list of VPC interfaces that you want to add to the flow.  
Type: Array of [VpcInterfaceRequest](API_VpcInterfaceRequest.md) objects  
Required: Yes

## Response Syntax
<a name="API_AddFlowVpcInterfaces_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "flowArn": "string",
   "vpcInterfaces": [ 
      { 
         "name": "string",
         "networkInterfaceIds": [ "string" ],
         "networkInterfaceType": "string",
         "roleArn": "string",
         "securityGroupIds": [ "string" ],
         "subnetId": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AddFlowVpcInterfaces_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_AddFlowVpcInterfaces_ResponseSyntax) **   <a name="mediaconnect-AddFlowVpcInterfaces-response-flowArn"></a>
 The ARN of the flow that these VPC interfaces were added to.  
Type: String

 ** [vpcInterfaces](#API_AddFlowVpcInterfaces_ResponseSyntax) **   <a name="mediaconnect-AddFlowVpcInterfaces-response-vpcInterfaces"></a>
 The details of the newly added VPC interfaces.  
Type: Array of [VpcInterface](API_VpcInterface.md) objects

## Errors
<a name="API_AddFlowVpcInterfaces_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_AddFlowVpcInterfaces_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/AddFlowVpcInterfaces) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/AddFlowVpcInterfaces) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/AddFlowVpcInterfaces) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/AddFlowVpcInterfaces) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/AddFlowVpcInterfaces) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/AddFlowVpcInterfaces) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/AddFlowVpcInterfaces) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/AddFlowVpcInterfaces) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/AddFlowVpcInterfaces) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/AddFlowVpcInterfaces) 

# BatchGetRouterInput
<a name="API_BatchGetRouterInput"></a>

Retrieves information about multiple router inputs in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_BatchGetRouterInput_RequestSyntax"></a>

```
GET /v1/routerInputs?arns=arns HTTP/1.1
```

## URI Request Parameters
<a name="API_BatchGetRouterInput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arns](#API_BatchGetRouterInput_RequestSyntax) **   <a name="mediaconnect-BatchGetRouterInput-request-uri-arns"></a>
The Amazon Resource Names (ARNs) of the router inputs you want to retrieve information about.  
Array Members: Minimum number of 1 item. Maximum number of 20 items.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_BatchGetRouterInput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_BatchGetRouterInput_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "errors": [ 
      { 
         "arn": "string",
         "code": "string",
         "message": "string"
      }
   ],
   "routerInputs": [ 
      { 
         "arn": "string",
         "availabilityZone": "string",
         "configuration": { ... },
         "createdAt": "string",
         "id": "string",
         "inputType": "string",
         "ipAddress": "string",
         "maintenanceConfiguration": { ... },
         "maintenanceSchedule": { ... },
         "maintenanceScheduleType": "string",
         "maintenanceType": "string",
         "maximumBitrate": number,
         "maximumRoutedOutputs": number,
         "messages": [ 
            { 
               "code": "string",
               "message": "string"
            }
         ],
         "name": "string",
         "regionName": "string",
         "routedOutputs": number,
         "routingScope": "string",
         "state": "string",
         "streamDetails": { ... },
         "tags": { 
            "string" : "string" 
         },
         "tier": "string",
         "transitEncryption": { 
            "encryptionKeyConfiguration": { ... },
            "encryptionKeyType": "string"
         },
         "updatedAt": "string"
      }
   ]
}
```

## Response Elements
<a name="API_BatchGetRouterInput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errors](#API_BatchGetRouterInput_ResponseSyntax) **   <a name="mediaconnect-BatchGetRouterInput-response-errors"></a>
An array of errors that occurred when retrieving the requested router inputs.  
Type: Array of [BatchGetRouterInputError](API_BatchGetRouterInputError.md) objects

 ** [routerInputs](#API_BatchGetRouterInput_ResponseSyntax) **   <a name="mediaconnect-BatchGetRouterInput-response-routerInputs"></a>
An array of router inputs that were successfully retrieved.  
Type: Array of [RouterInput](API_RouterInput.md) objects

## Errors
<a name="API_BatchGetRouterInput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_BatchGetRouterInput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/BatchGetRouterInput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/BatchGetRouterInput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/BatchGetRouterInput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/BatchGetRouterInput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/BatchGetRouterInput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/BatchGetRouterInput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/BatchGetRouterInput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/BatchGetRouterInput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/BatchGetRouterInput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/BatchGetRouterInput) 

# BatchGetRouterNetworkInterface
<a name="API_BatchGetRouterNetworkInterface"></a>

Retrieves information about multiple router network interfaces in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_BatchGetRouterNetworkInterface_RequestSyntax"></a>

```
GET /v1/routerNetworkInterfaces?arns=arns HTTP/1.1
```

## URI Request Parameters
<a name="API_BatchGetRouterNetworkInterface_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arns](#API_BatchGetRouterNetworkInterface_RequestSyntax) **   <a name="mediaconnect-BatchGetRouterNetworkInterface-request-uri-arns"></a>
The Amazon Resource Names (ARNs) of the router network interfaces you want to retrieve information about.  
Array Members: Minimum number of 1 item. Maximum number of 20 items.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerNetworkInterface:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_BatchGetRouterNetworkInterface_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_BatchGetRouterNetworkInterface_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "errors": [ 
      { 
         "arn": "string",
         "code": "string",
         "message": "string"
      }
   ],
   "routerNetworkInterfaces": [ 
      { 
         "arn": "string",
         "associatedInputCount": number,
         "associatedOutputCount": number,
         "configuration": { ... },
         "createdAt": "string",
         "id": "string",
         "name": "string",
         "networkInterfaceType": "string",
         "regionName": "string",
         "state": "string",
         "tags": { 
            "string" : "string" 
         },
         "updatedAt": "string"
      }
   ]
}
```

## Response Elements
<a name="API_BatchGetRouterNetworkInterface_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errors](#API_BatchGetRouterNetworkInterface_ResponseSyntax) **   <a name="mediaconnect-BatchGetRouterNetworkInterface-response-errors"></a>
An array of errors that occurred when retrieving the requested router network interfaces.  
Type: Array of [BatchGetRouterNetworkInterfaceError](API_BatchGetRouterNetworkInterfaceError.md) objects

 ** [routerNetworkInterfaces](#API_BatchGetRouterNetworkInterface_ResponseSyntax) **   <a name="mediaconnect-BatchGetRouterNetworkInterface-response-routerNetworkInterfaces"></a>
An array of router network interfaces that were successfully retrieved.  
Type: Array of [RouterNetworkInterface](API_RouterNetworkInterface.md) objects

## Errors
<a name="API_BatchGetRouterNetworkInterface_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_BatchGetRouterNetworkInterface_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/BatchGetRouterNetworkInterface) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/BatchGetRouterNetworkInterface) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/BatchGetRouterNetworkInterface) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/BatchGetRouterNetworkInterface) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/BatchGetRouterNetworkInterface) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/BatchGetRouterNetworkInterface) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/BatchGetRouterNetworkInterface) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/BatchGetRouterNetworkInterface) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/BatchGetRouterNetworkInterface) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/BatchGetRouterNetworkInterface) 

# BatchGetRouterOutput
<a name="API_BatchGetRouterOutput"></a>

Retrieves information about multiple router outputs in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_BatchGetRouterOutput_RequestSyntax"></a>

```
GET /v1/routerOutputs?arns=arns HTTP/1.1
```

## URI Request Parameters
<a name="API_BatchGetRouterOutput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arns](#API_BatchGetRouterOutput_RequestSyntax) **   <a name="mediaconnect-BatchGetRouterOutput-request-uri-arns"></a>
The Amazon Resource Names (ARNs) of the router outputs you want to retrieve information about.  
Array Members: Minimum number of 1 item. Maximum number of 20 items.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerOutput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_BatchGetRouterOutput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_BatchGetRouterOutput_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "errors": [ 
      { 
         "arn": "string",
         "code": "string",
         "message": "string"
      }
   ],
   "routerOutputs": [ 
      { 
         "arn": "string",
         "availabilityZone": "string",
         "configuration": { ... },
         "createdAt": "string",
         "id": "string",
         "ipAddress": "string",
         "maintenanceConfiguration": { ... },
         "maintenanceSchedule": { ... },
         "maintenanceScheduleType": "string",
         "maintenanceType": "string",
         "maximumBitrate": number,
         "messages": [ 
            { 
               "code": "string",
               "message": "string"
            }
         ],
         "name": "string",
         "outputType": "string",
         "regionName": "string",
         "routedInputArn": "string",
         "routedState": "string",
         "routingScope": "string",
         "state": "string",
         "streamDetails": { ... },
         "tags": { 
            "string" : "string" 
         },
         "tier": "string",
         "updatedAt": "string"
      }
   ]
}
```

## Response Elements
<a name="API_BatchGetRouterOutput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errors](#API_BatchGetRouterOutput_ResponseSyntax) **   <a name="mediaconnect-BatchGetRouterOutput-response-errors"></a>
An array of errors that occurred when retrieving the requested router outputs.  
Type: Array of [BatchGetRouterOutputError](API_BatchGetRouterOutputError.md) objects

 ** [routerOutputs](#API_BatchGetRouterOutput_ResponseSyntax) **   <a name="mediaconnect-BatchGetRouterOutput-response-routerOutputs"></a>
An array of router outputs that were successfully retrieved.  
Type: Array of [RouterOutput](API_RouterOutput.md) objects

## Errors
<a name="API_BatchGetRouterOutput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_BatchGetRouterOutput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/BatchGetRouterOutput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/BatchGetRouterOutput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/BatchGetRouterOutput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/BatchGetRouterOutput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/BatchGetRouterOutput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/BatchGetRouterOutput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/BatchGetRouterOutput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/BatchGetRouterOutput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/BatchGetRouterOutput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/BatchGetRouterOutput) 

# CreateBridge
<a name="API_CreateBridge"></a>

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

## Request Syntax
<a name="API_CreateBridge_RequestSyntax"></a>

```
POST /v1/bridges HTTP/1.1
Content-type: application/json

{
   "egressGatewayBridge": { 
      "maxBitrate": number
   },
   "ingressGatewayBridge": { 
      "maxBitrate": number,
      "maxOutputs": number
   },
   "name": "string",
   "outputs": [ 
      { 
         "networkOutput": { 
            "ipAddress": "string",
            "name": "string",
            "networkName": "string",
            "port": number,
            "protocol": "string",
            "ttl": number
         }
      }
   ],
   "placementArn": "string",
   "sourceFailoverConfig": { 
      "failoverMode": "string",
      "recoveryWindow": number,
      "sourcePriority": { 
         "primarySource": "string"
      },
      "state": "string"
   },
   "sources": [ 
      { 
         "flowSource": { 
            "flowArn": "string",
            "flowVpcInterfaceAttachment": { 
               "vpcInterfaceName": "string"
            },
            "name": "string"
         },
         "networkSource": { 
            "multicastIp": "string",
            "multicastSourceSettings": { 
               "multicastSourceIp": "string"
            },
            "name": "string",
            "networkName": "string",
            "port": number,
            "protocol": "string"
         }
      }
   ]
}
```

## URI Request Parameters
<a name="API_CreateBridge_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateBridge_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [egressGatewayBridge](#API_CreateBridge_RequestSyntax) **   <a name="mediaconnect-CreateBridge-request-egressGatewayBridge"></a>
An egress bridge is a cloud-to-ground bridge. The content comes from an existing MediaConnect flow and is delivered to your premises.   
Type: [AddEgressGatewayBridgeRequest](API_AddEgressGatewayBridgeRequest.md) object  
Required: No

 ** [ingressGatewayBridge](#API_CreateBridge_RequestSyntax) **   <a name="mediaconnect-CreateBridge-request-ingressGatewayBridge"></a>
An ingress bridge is a ground-to-cloud bridge. The content originates at your premises and is delivered to the cloud.   
Type: [AddIngressGatewayBridgeRequest](API_AddIngressGatewayBridgeRequest.md) object  
Required: No

 ** [name](#API_CreateBridge_RequestSyntax) **   <a name="mediaconnect-CreateBridge-request-name"></a>
 The name of the bridge. This name can not be modified after the bridge is created.  
Type: String  
Required: Yes

 ** [outputs](#API_CreateBridge_RequestSyntax) **   <a name="mediaconnect-CreateBridge-request-outputs"></a>
 The outputs that you want to add to this bridge.  
Type: Array of [AddBridgeOutputRequest](API_AddBridgeOutputRequest.md) objects  
Required: No

 ** [placementArn](#API_CreateBridge_RequestSyntax) **   <a name="mediaconnect-CreateBridge-request-placementArn"></a>
 The bridge placement Amazon Resource Number (ARN).  
Type: String  
Required: Yes

 ** [sourceFailoverConfig](#API_CreateBridge_RequestSyntax) **   <a name="mediaconnect-CreateBridge-request-sourceFailoverConfig"></a>
 The settings for source failover.  
Type: [FailoverConfig](API_FailoverConfig.md) object  
Required: No

 ** [sources](#API_CreateBridge_RequestSyntax) **   <a name="mediaconnect-CreateBridge-request-sources"></a>
 The sources that you want to add to this bridge.  
Type: Array of [AddBridgeSourceRequest](API_AddBridgeSourceRequest.md) objects  
Required: Yes

## Response Syntax
<a name="API_CreateBridge_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "bridge": { 
      "bridgeArn": "string",
      "bridgeMessages": [ 
         { 
            "code": "string",
            "message": "string",
            "resourceName": "string"
         }
      ],
      "bridgeState": "string",
      "egressGatewayBridge": { 
         "instanceId": "string",
         "maxBitrate": number
      },
      "ingressGatewayBridge": { 
         "instanceId": "string",
         "maxBitrate": number,
         "maxOutputs": number
      },
      "name": "string",
      "outputs": [ 
         { 
            "flowOutput": { 
               "flowArn": "string",
               "flowSourceArn": "string",
               "name": "string"
            },
            "networkOutput": { 
               "ipAddress": "string",
               "name": "string",
               "networkName": "string",
               "port": number,
               "protocol": "string",
               "ttl": number
            }
         }
      ],
      "placementArn": "string",
      "sourceFailoverConfig": { 
         "failoverMode": "string",
         "recoveryWindow": number,
         "sourcePriority": { 
            "primarySource": "string"
         },
         "state": "string"
      },
      "sources": [ 
         { 
            "flowSource": { 
               "flowArn": "string",
               "flowVpcInterfaceAttachment": { 
                  "vpcInterfaceName": "string"
               },
               "name": "string",
               "outputArn": "string"
            },
            "networkSource": { 
               "multicastIp": "string",
               "multicastSourceSettings": { 
                  "multicastSourceIp": "string"
               },
               "name": "string",
               "networkName": "string",
               "port": number,
               "protocol": "string"
            }
         }
      ]
   }
}
```

## Response Elements
<a name="API_CreateBridge_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [bridge](#API_CreateBridge_ResponseSyntax) **   <a name="mediaconnect-CreateBridge-response-bridge"></a>
 The name of the bridge that was created.  
Type: [Bridge](API_Bridge.md) object

## Errors
<a name="API_CreateBridge_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** CreateBridge420Exception **   
Exception raised by AWS Elemental MediaConnect when creating the bridge. See the error message for the operation for more information on the cause of this exception.   
HTTP Status Code: 420

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_CreateBridge_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/CreateBridge) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/CreateBridge) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/CreateBridge) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/CreateBridge) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/CreateBridge) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/CreateBridge) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/CreateBridge) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/CreateBridge) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/CreateBridge) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/CreateBridge) 

# CreateFlow
<a name="API_CreateFlow"></a>

 Creates a new flow. The request must include one source. The request optionally can include outputs (up to 50) and entitlements (up to 50).

## Request Syntax
<a name="API_CreateFlow_RequestSyntax"></a>

```
POST /v1/flows HTTP/1.1
Content-type: application/json

{
   "availabilityZone": "string",
   "encodingConfig": { 
      "encodingProfile": "string",
      "videoMaxBitrate": number
   },
   "entitlements": [ 
      { 
         "dataTransferSubscriberFeePercent": number,
         "description": "string",
         "encryption": { 
            "algorithm": "string",
            "constantInitializationVector": "string",
            "deviceId": "string",
            "keyType": "string",
            "region": "string",
            "resourceId": "string",
            "roleArn": "string",
            "secretArn": "string",
            "url": "string"
         },
         "entitlementStatus": "string",
         "entitlementTags": { 
            "string" : "string" 
         },
         "name": "string",
         "subscribers": [ "string" ]
      }
   ],
   "flowSize": "string",
   "flowTags": { 
      "string" : "string" 
   },
   "maintenance": { 
      "maintenanceDay": "string",
      "maintenanceStartHour": "string"
   },
   "mediaStreams": [ 
      { 
         "attributes": { 
            "fmtp": { 
               "channelOrder": "string",
               "colorimetry": "string",
               "exactFramerate": "string",
               "par": "string",
               "range": "string",
               "scanMode": "string",
               "tcs": "string"
            },
            "lang": "string"
         },
         "clockRate": number,
         "description": "string",
         "mediaStreamId": number,
         "mediaStreamName": "string",
         "mediaStreamTags": { 
            "string" : "string" 
         },
         "mediaStreamType": "string",
         "videoFormat": "string"
      }
   ],
   "name": "string",
   "ndiConfig": { 
      "machineName": "string",
      "ndiDiscoveryServers": [ 
         { 
            "discoveryServerAddress": "string",
            "discoveryServerPort": number,
            "vpcInterfaceAdapter": "string"
         }
      ],
      "ndiState": "string"
   },
   "outputs": [ 
      { 
         "cidrAllowList": [ "string" ],
         "description": "string",
         "destination": "string",
         "encryption": { 
            "algorithm": "string",
            "constantInitializationVector": "string",
            "deviceId": "string",
            "keyType": "string",
            "region": "string",
            "resourceId": "string",
            "roleArn": "string",
            "secretArn": "string",
            "url": "string"
         },
         "maxLatency": number,
         "mediaStreamOutputConfigurations": [ 
            { 
               "destinationConfigurations": [ 
                  { 
                     "destinationIp": "string",
                     "destinationPort": number,
                     "interface": { 
                        "name": "string"
                     }
                  }
               ],
               "encodingName": "string",
               "encodingParameters": { 
                  "compressionFactor": number,
                  "encoderProfile": "string"
               },
               "mediaStreamName": "string"
            }
         ],
         "minLatency": number,
         "name": "string",
         "ndiProgramName": "string",
         "ndiSpeedHqQuality": number,
         "outputStatus": "string",
         "outputTags": { 
            "string" : "string" 
         },
         "port": number,
         "protocol": "string",
         "remoteId": "string",
         "routerIntegrationState": "string",
         "routerIntegrationTransitEncryption": { 
            "encryptionKeyConfiguration": { ... },
            "encryptionKeyType": "string"
         },
         "senderControlPort": number,
         "smoothingLatency": number,
         "streamId": "string",
         "vpcInterfaceAttachment": { 
            "vpcInterfaceName": "string"
         }
      }
   ],
   "source": { 
      "decryption": { 
         "algorithm": "string",
         "constantInitializationVector": "string",
         "deviceId": "string",
         "keyType": "string",
         "region": "string",
         "resourceId": "string",
         "roleArn": "string",
         "secretArn": "string",
         "url": "string"
      },
      "description": "string",
      "entitlementArn": "string",
      "gatewayBridgeSource": { 
         "bridgeArn": "string",
         "vpcInterfaceAttachment": { 
            "vpcInterfaceName": "string"
         }
      },
      "ingestPort": number,
      "maxBitrate": number,
      "maxLatency": number,
      "maxSyncBuffer": number,
      "mediaStreamSourceConfigurations": [ 
         { 
            "encodingName": "string",
            "inputConfigurations": [ 
               { 
                  "inputPort": number,
                  "interface": { 
                     "name": "string"
                  }
               }
            ],
            "mediaStreamName": "string"
         }
      ],
      "minLatency": number,
      "name": "string",
      "ndiSourceSettings": { 
         "sourceName": "string"
      },
      "protocol": "string",
      "routerIntegrationState": "string",
      "routerIntegrationTransitDecryption": { 
         "encryptionKeyConfiguration": { ... },
         "encryptionKeyType": "string"
      },
      "senderControlPort": number,
      "senderIpAddress": "string",
      "sourceListenerAddress": "string",
      "sourceListenerPort": number,
      "sourceTags": { 
         "string" : "string" 
      },
      "streamId": "string",
      "vpcInterfaceName": "string",
      "whitelistCidr": "string"
   },
   "sourceFailoverConfig": { 
      "failoverMode": "string",
      "recoveryWindow": number,
      "sourcePriority": { 
         "primarySource": "string"
      },
      "state": "string"
   },
   "sourceMonitoringConfig": { 
      "audioMonitoringSettings": [ 
         { 
            "silentAudio": { 
               "state": "string",
               "thresholdSeconds": number
            }
         }
      ],
      "contentQualityAnalysisState": "string",
      "thumbnailState": "string",
      "videoMonitoringSettings": [ 
         { 
            "blackFrames": { 
               "state": "string",
               "thresholdSeconds": number
            },
            "frozenFrames": { 
               "state": "string",
               "thresholdSeconds": number
            }
         }
      ]
   },
   "sources": [ 
      { 
         "decryption": { 
            "algorithm": "string",
            "constantInitializationVector": "string",
            "deviceId": "string",
            "keyType": "string",
            "region": "string",
            "resourceId": "string",
            "roleArn": "string",
            "secretArn": "string",
            "url": "string"
         },
         "description": "string",
         "entitlementArn": "string",
         "gatewayBridgeSource": { 
            "bridgeArn": "string",
            "vpcInterfaceAttachment": { 
               "vpcInterfaceName": "string"
            }
         },
         "ingestPort": number,
         "maxBitrate": number,
         "maxLatency": number,
         "maxSyncBuffer": number,
         "mediaStreamSourceConfigurations": [ 
            { 
               "encodingName": "string",
               "inputConfigurations": [ 
                  { 
                     "inputPort": number,
                     "interface": { 
                        "name": "string"
                     }
                  }
               ],
               "mediaStreamName": "string"
            }
         ],
         "minLatency": number,
         "name": "string",
         "ndiSourceSettings": { 
            "sourceName": "string"
         },
         "protocol": "string",
         "routerIntegrationState": "string",
         "routerIntegrationTransitDecryption": { 
            "encryptionKeyConfiguration": { ... },
            "encryptionKeyType": "string"
         },
         "senderControlPort": number,
         "senderIpAddress": "string",
         "sourceListenerAddress": "string",
         "sourceListenerPort": number,
         "sourceTags": { 
            "string" : "string" 
         },
         "streamId": "string",
         "vpcInterfaceName": "string",
         "whitelistCidr": "string"
      }
   ],
   "vpcInterfaces": [ 
      { 
         "name": "string",
         "networkInterfaceType": "string",
         "roleArn": "string",
         "securityGroupIds": [ "string" ],
         "subnetId": "string",
         "vpcInterfaceTags": { 
            "string" : "string" 
         }
      }
   ]
}
```

## URI Request Parameters
<a name="API_CreateFlow_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateFlow_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [availabilityZone](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-availabilityZone"></a>
 The Availability Zone that you want to create the flow in. These options are limited to the Availability Zones within the current AWS Region.  
Type: String  
Required: No

 ** [encodingConfig](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-encodingConfig"></a>
 The encoding configuration to apply to the NDI® source when transcoding it to a transport stream for downstream distribution. You can choose between several predefined encoding profiles based on common use cases.   
Type: [EncodingConfig](API_EncodingConfig.md) object  
Required: No

 ** [entitlements](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-entitlements"></a>
 The entitlements that you want to grant on a flow.  
Type: Array of [GrantEntitlementRequest](API_GrantEntitlementRequest.md) objects  
Required: No

 ** [flowSize](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-flowSize"></a>
 Determines the processing capacity and feature set of the flow. Set this optional parameter to `LARGE` if you want to enable NDI sources or outputs on the flow.   
Type: String  
Valid Values: `MEDIUM | LARGE | LARGE_4X`   
Required: No

 ** [flowTags](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-flowTags"></a>
 The key-value pairs that can be used to tag and organize the flow.   
Type: String to string map  
Required: No

 ** [maintenance](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-maintenance"></a>
 The maintenance settings you want to use for the flow.   
Type: [AddMaintenance](API_AddMaintenance.md) object  
Required: No

 ** [mediaStreams](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-mediaStreams"></a>
 The media streams that you want to add to the flow. You can associate these media streams with sources and outputs on the flow.  
Type: Array of [AddMediaStreamRequest](API_AddMediaStreamRequest.md) objects  
Required: No

 ** [name](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-name"></a>
 The name of the flow.  
Type: String  
Required: Yes

 ** [ndiConfig](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-ndiConfig"></a>
 Specifies the configuration settings for a flow's NDI source or output. Required when the flow includes an NDI source or output.   
Type: [NdiConfig](API_NdiConfig.md) object  
Required: No

 ** [outputs](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-outputs"></a>
 The outputs that you want to add to this flow.  
Type: Array of [AddOutputRequest](API_AddOutputRequest.md) objects  
Required: No

 ** [source](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-source"></a>
 The settings for the source that you want to use for the new flow.   
Type: [SetSourceRequest](API_SetSourceRequest.md) object  
Required: No

 ** [sourceFailoverConfig](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-sourceFailoverConfig"></a>
 The settings for source failover.   
Type: [FailoverConfig](API_FailoverConfig.md) object  
Required: No

 ** [sourceMonitoringConfig](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-sourceMonitoringConfig"></a>
 The settings for source monitoring.   
Type: [MonitoringConfig](API_MonitoringConfig.md) object  
Required: No

 ** [sources](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-sources"></a>
The sources that are assigned to the flow.   
Type: Array of [SetSourceRequest](API_SetSourceRequest.md) objects  
Required: No

 ** [vpcInterfaces](#API_CreateFlow_RequestSyntax) **   <a name="mediaconnect-CreateFlow-request-vpcInterfaces"></a>
 The VPC interfaces you want on the flow.  
Type: Array of [VpcInterfaceRequest](API_VpcInterfaceRequest.md) objects  
Required: No

## Response Syntax
<a name="API_CreateFlow_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "flow": { 
      "availabilityZone": "string",
      "description": "string",
      "egressIp": "string",
      "encodingConfig": { 
         "encodingProfile": "string",
         "videoMaxBitrate": number
      },
      "entitlements": [ 
         { 
            "dataTransferSubscriberFeePercent": number,
            "description": "string",
            "encryption": { 
               "algorithm": "string",
               "constantInitializationVector": "string",
               "deviceId": "string",
               "keyType": "string",
               "region": "string",
               "resourceId": "string",
               "roleArn": "string",
               "secretArn": "string",
               "url": "string"
            },
            "entitlementArn": "string",
            "entitlementStatus": "string",
            "name": "string",
            "subscribers": [ "string" ]
         }
      ],
      "flowArn": "string",
      "flowSize": "string",
      "maintenance": { 
         "maintenanceDay": "string",
         "maintenanceDeadline": "string",
         "maintenanceScheduledDate": "string",
         "maintenanceStartHour": "string"
      },
      "mediaStreams": [ 
         { 
            "attributes": { 
               "fmtp": { 
                  "channelOrder": "string",
                  "colorimetry": "string",
                  "exactFramerate": "string",
                  "par": "string",
                  "range": "string",
                  "scanMode": "string",
                  "tcs": "string"
               },
               "lang": "string"
            },
            "clockRate": number,
            "description": "string",
            "fmt": number,
            "mediaStreamId": number,
            "mediaStreamName": "string",
            "mediaStreamType": "string",
            "videoFormat": "string"
         }
      ],
      "name": "string",
      "ndiConfig": { 
         "machineName": "string",
         "ndiDiscoveryServers": [ 
            { 
               "discoveryServerAddress": "string",
               "discoveryServerPort": number,
               "vpcInterfaceAdapter": "string"
            }
         ],
         "ndiState": "string"
      },
      "outputs": [ 
         { 
            "bridgeArn": "string",
            "bridgePorts": [ number ],
            "connectedRouterInputArn": "string",
            "dataTransferSubscriberFeePercent": number,
            "description": "string",
            "destination": "string",
            "encryption": { 
               "algorithm": "string",
               "constantInitializationVector": "string",
               "deviceId": "string",
               "keyType": "string",
               "region": "string",
               "resourceId": "string",
               "roleArn": "string",
               "secretArn": "string",
               "url": "string"
            },
            "entitlementArn": "string",
            "listenerAddress": "string",
            "mediaLiveInputArn": "string",
            "mediaStreamOutputConfigurations": [ 
               { 
                  "destinationConfigurations": [ 
                     { 
                        "destinationIp": "string",
                        "destinationPort": number,
                        "interface": { 
                           "name": "string"
                        },
                        "outboundIp": "string"
                     }
                  ],
                  "encodingName": "string",
                  "encodingParameters": { 
                     "compressionFactor": number,
                     "encoderProfile": "string"
                  },
                  "mediaStreamName": "string"
               }
            ],
            "name": "string",
            "outputArn": "string",
            "outputStatus": "string",
            "peerIpAddress": "string",
            "port": number,
            "routerIntegrationState": "string",
            "routerIntegrationTransitEncryption": { 
               "encryptionKeyConfiguration": { ... },
               "encryptionKeyType": "string"
            },
            "transport": { 
               "cidrAllowList": [ "string" ],
               "maxBitrate": number,
               "maxLatency": number,
               "maxSyncBuffer": number,
               "minLatency": number,
               "ndiProgramName": "string",
               "ndiSourceSettings": { 
                  "sourceName": "string"
               },
               "ndiSpeedHqQuality": number,
               "protocol": "string",
               "remoteId": "string",
               "senderControlPort": number,
               "senderIpAddress": "string",
               "smoothingLatency": number,
               "sourceListenerAddress": "string",
               "sourceListenerPort": number,
               "streamId": "string"
            },
            "vpcInterfaceAttachment": { 
               "vpcInterfaceName": "string"
            }
         }
      ],
      "source": { 
         "connectedRouterOutputArn": "string",
         "dataTransferSubscriberFeePercent": number,
         "decryption": { 
            "algorithm": "string",
            "constantInitializationVector": "string",
            "deviceId": "string",
            "keyType": "string",
            "region": "string",
            "resourceId": "string",
            "roleArn": "string",
            "secretArn": "string",
            "url": "string"
         },
         "description": "string",
         "entitlementArn": "string",
         "gatewayBridgeSource": { 
            "bridgeArn": "string",
            "vpcInterfaceAttachment": { 
               "vpcInterfaceName": "string"
            }
         },
         "ingestIp": "string",
         "ingestPort": number,
         "mediaStreamSourceConfigurations": [ 
            { 
               "encodingName": "string",
               "inputConfigurations": [ 
                  { 
                     "inputIp": "string",
                     "inputPort": number,
                     "interface": { 
                        "name": "string"
                     }
                  }
               ],
               "mediaStreamName": "string"
            }
         ],
         "name": "string",
         "peerIpAddress": "string",
         "routerIntegrationState": "string",
         "routerIntegrationTransitDecryption": { 
            "encryptionKeyConfiguration": { ... },
            "encryptionKeyType": "string"
         },
         "senderControlPort": number,
         "senderIpAddress": "string",
         "sourceArn": "string",
         "transport": { 
            "cidrAllowList": [ "string" ],
            "maxBitrate": number,
            "maxLatency": number,
            "maxSyncBuffer": number,
            "minLatency": number,
            "ndiProgramName": "string",
            "ndiSourceSettings": { 
               "sourceName": "string"
            },
            "ndiSpeedHqQuality": number,
            "protocol": "string",
            "remoteId": "string",
            "senderControlPort": number,
            "senderIpAddress": "string",
            "smoothingLatency": number,
            "sourceListenerAddress": "string",
            "sourceListenerPort": number,
            "streamId": "string"
         },
         "vpcInterfaceName": "string",
         "whitelistCidr": "string"
      },
      "sourceFailoverConfig": { 
         "failoverMode": "string",
         "recoveryWindow": number,
         "sourcePriority": { 
            "primarySource": "string"
         },
         "state": "string"
      },
      "sourceMonitoringConfig": { 
         "audioMonitoringSettings": [ 
            { 
               "silentAudio": { 
                  "state": "string",
                  "thresholdSeconds": number
               }
            }
         ],
         "contentQualityAnalysisState": "string",
         "thumbnailState": "string",
         "videoMonitoringSettings": [ 
            { 
               "blackFrames": { 
                  "state": "string",
                  "thresholdSeconds": number
               },
               "frozenFrames": { 
                  "state": "string",
                  "thresholdSeconds": number
               }
            }
         ]
      },
      "sources": [ 
         { 
            "connectedRouterOutputArn": "string",
            "dataTransferSubscriberFeePercent": number,
            "decryption": { 
               "algorithm": "string",
               "constantInitializationVector": "string",
               "deviceId": "string",
               "keyType": "string",
               "region": "string",
               "resourceId": "string",
               "roleArn": "string",
               "secretArn": "string",
               "url": "string"
            },
            "description": "string",
            "entitlementArn": "string",
            "gatewayBridgeSource": { 
               "bridgeArn": "string",
               "vpcInterfaceAttachment": { 
                  "vpcInterfaceName": "string"
               }
            },
            "ingestIp": "string",
            "ingestPort": number,
            "mediaStreamSourceConfigurations": [ 
               { 
                  "encodingName": "string",
                  "inputConfigurations": [ 
                     { 
                        "inputIp": "string",
                        "inputPort": number,
                        "interface": { 
                           "name": "string"
                        }
                     }
                  ],
                  "mediaStreamName": "string"
               }
            ],
            "name": "string",
            "peerIpAddress": "string",
            "routerIntegrationState": "string",
            "routerIntegrationTransitDecryption": { 
               "encryptionKeyConfiguration": { ... },
               "encryptionKeyType": "string"
            },
            "senderControlPort": number,
            "senderIpAddress": "string",
            "sourceArn": "string",
            "transport": { 
               "cidrAllowList": [ "string" ],
               "maxBitrate": number,
               "maxLatency": number,
               "maxSyncBuffer": number,
               "minLatency": number,
               "ndiProgramName": "string",
               "ndiSourceSettings": { 
                  "sourceName": "string"
               },
               "ndiSpeedHqQuality": number,
               "protocol": "string",
               "remoteId": "string",
               "senderControlPort": number,
               "senderIpAddress": "string",
               "smoothingLatency": number,
               "sourceListenerAddress": "string",
               "sourceListenerPort": number,
               "streamId": "string"
            },
            "vpcInterfaceName": "string",
            "whitelistCidr": "string"
         }
      ],
      "status": "string",
      "vpcInterfaces": [ 
         { 
            "name": "string",
            "networkInterfaceIds": [ "string" ],
            "networkInterfaceType": "string",
            "roleArn": "string",
            "securityGroupIds": [ "string" ],
            "subnetId": "string"
         }
      ]
   }
}
```

## Response Elements
<a name="API_CreateFlow_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [flow](#API_CreateFlow_ResponseSyntax) **   <a name="mediaconnect-CreateFlow-response-flow"></a>
 The flow that you created.   
Type: [Flow](API_Flow.md) object

## Errors
<a name="API_CreateFlow_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** CreateFlow420Exception **   
Exception raised by AWS Elemental MediaConnect when creating the flow. See the error message for the operation for more information on the cause of this exception.   
HTTP Status Code: 420

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_CreateFlow_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/CreateFlow) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/CreateFlow) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/CreateFlow) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/CreateFlow) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/CreateFlow) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/CreateFlow) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/CreateFlow) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/CreateFlow) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/CreateFlow) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/CreateFlow) 

# CreateGateway
<a name="API_CreateGateway"></a>

 Creates a new gateway. The request must include at least one network (up to four).

## Request Syntax
<a name="API_CreateGateway_RequestSyntax"></a>

```
POST /v1/gateways HTTP/1.1
Content-type: application/json

{
   "egressCidrBlocks": [ "string" ],
   "name": "string",
   "networks": [ 
      { 
         "cidrBlock": "string",
         "name": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_CreateGateway_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateGateway_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [egressCidrBlocks](#API_CreateGateway_RequestSyntax) **   <a name="mediaconnect-CreateGateway-request-egressCidrBlocks"></a>
 The range of IP addresses that are allowed to contribute content or initiate output requests for flows communicating with this gateway. These IP addresses should be in the form of a Classless Inter-Domain Routing (CIDR) block; for example, 10.0.0.0/16.  
Type: Array of strings  
Required: Yes

 ** [name](#API_CreateGateway_RequestSyntax) **   <a name="mediaconnect-CreateGateway-request-name"></a>
 The name of the gateway. This name can not be modified after the gateway is created.  
Type: String  
Required: Yes

 ** [networks](#API_CreateGateway_RequestSyntax) **   <a name="mediaconnect-CreateGateway-request-networks"></a>
 The list of networks that you want to add to the gateway.  
Type: Array of [GatewayNetwork](API_GatewayNetwork.md) objects  
Required: Yes

## Response Syntax
<a name="API_CreateGateway_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "gateway": { 
      "egressCidrBlocks": [ "string" ],
      "gatewayArn": "string",
      "gatewayMessages": [ 
         { 
            "code": "string",
            "message": "string",
            "resourceName": "string"
         }
      ],
      "gatewayState": "string",
      "name": "string",
      "networks": [ 
         { 
            "cidrBlock": "string",
            "name": "string"
         }
      ]
   }
}
```

## Response Elements
<a name="API_CreateGateway_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [gateway](#API_CreateGateway_ResponseSyntax) **   <a name="mediaconnect-CreateGateway-response-gateway"></a>
 The gateway that you created.   
Type: [Gateway](API_Gateway.md) object

## Errors
<a name="API_CreateGateway_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** CreateGateway420Exception **   
Exception raised by AWS Elemental MediaConnect when creating the gateway. See the error message for the operation for more information on the cause of this exception.   
HTTP Status Code: 420

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_CreateGateway_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/CreateGateway) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/CreateGateway) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/CreateGateway) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/CreateGateway) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/CreateGateway) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/CreateGateway) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/CreateGateway) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/CreateGateway) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/CreateGateway) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/CreateGateway) 

# CreateRouterInput
<a name="API_CreateRouterInput"></a>

Creates a new router input in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_CreateRouterInput_RequestSyntax"></a>

```
POST /v1/routerInput HTTP/1.1
Content-type: application/json

{
   "availabilityZone": "string",
   "clientToken": "string",
   "configuration": { ... },
   "maintenanceConfiguration": { ... },
   "maximumBitrate": number,
   "name": "string",
   "regionName": "string",
   "routingScope": "string",
   "tags": { 
      "string" : "string" 
   },
   "tier": "string",
   "transitEncryption": { 
      "encryptionKeyConfiguration": { ... },
      "encryptionKeyType": "string"
   }
}
```

## URI Request Parameters
<a name="API_CreateRouterInput_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateRouterInput_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [availabilityZone](#API_CreateRouterInput_RequestSyntax) **   <a name="mediaconnect-CreateRouterInput-request-availabilityZone"></a>
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: String  
Required: No

 ** [clientToken](#API_CreateRouterInput_RequestSyntax) **   <a name="mediaconnect-CreateRouterInput-request-clientToken"></a>
A unique identifier for the request to ensure idempotency.  
Type: String  
Required: No

 ** [configuration](#API_CreateRouterInput_RequestSyntax) **   <a name="mediaconnect-CreateRouterInput-request-configuration"></a>
The configuration settings for the router input, which can include the protocol, network interface, and other details.  
Type: [RouterInputConfiguration](API_RouterInputConfiguration.md) object  
 **Note: **This object is a Union. Only one member of this object can be specified or returned.  
Required: Yes

 ** [maintenanceConfiguration](#API_CreateRouterInput_RequestSyntax) **   <a name="mediaconnect-CreateRouterInput-request-maintenanceConfiguration"></a>
The maintenance configuration settings for the router input, including preferred maintenance windows and schedules.  
Type: [MaintenanceConfiguration](API_MaintenanceConfiguration.md) object  
 **Note: **This object is a Union. Only one member of this object can be specified or returned.  
Required: No

 ** [maximumBitrate](#API_CreateRouterInput_RequestSyntax) **   <a name="mediaconnect-CreateRouterInput-request-maximumBitrate"></a>
The maximum bitrate for the router input.  
Type: Long  
Required: Yes

 ** [name](#API_CreateRouterInput_RequestSyntax) **   <a name="mediaconnect-CreateRouterInput-request-name"></a>
The name of the router input.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Required: Yes

 ** [regionName](#API_CreateRouterInput_RequestSyntax) **   <a name="mediaconnect-CreateRouterInput-request-regionName"></a>
The AWS Region for the router input. Defaults to the current region if not specified.  
Type: String  
Required: No

 ** [routingScope](#API_CreateRouterInput_RequestSyntax) **   <a name="mediaconnect-CreateRouterInput-request-routingScope"></a>
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: String  
Valid Values: `REGIONAL | GLOBAL`   
Required: Yes

 ** [tags](#API_CreateRouterInput_RequestSyntax) **   <a name="mediaconnect-CreateRouterInput-request-tags"></a>
Key-value pairs that can be used to tag and organize this router input.  
Type: String to string map  
Required: No

 ** [tier](#API_CreateRouterInput_RequestSyntax) **   <a name="mediaconnect-CreateRouterInput-request-tier"></a>
The tier level for the router input.  
Type: String  
Valid Values: `INPUT_100 | INPUT_50 | INPUT_20`   
Required: Yes

 ** [transitEncryption](#API_CreateRouterInput_RequestSyntax) **   <a name="mediaconnect-CreateRouterInput-request-transitEncryption"></a>
The transit encryption settings for the router input.  
Type: [RouterInputTransitEncryption](API_RouterInputTransitEncryption.md) object  
Required: No

## Response Syntax
<a name="API_CreateRouterInput_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "routerInput": { 
      "arn": "string",
      "availabilityZone": "string",
      "configuration": { ... },
      "createdAt": "string",
      "id": "string",
      "inputType": "string",
      "ipAddress": "string",
      "maintenanceConfiguration": { ... },
      "maintenanceSchedule": { ... },
      "maintenanceScheduleType": "string",
      "maintenanceType": "string",
      "maximumBitrate": number,
      "maximumRoutedOutputs": number,
      "messages": [ 
         { 
            "code": "string",
            "message": "string"
         }
      ],
      "name": "string",
      "regionName": "string",
      "routedOutputs": number,
      "routingScope": "string",
      "state": "string",
      "streamDetails": { ... },
      "tags": { 
         "string" : "string" 
      },
      "tier": "string",
      "transitEncryption": { 
         "encryptionKeyConfiguration": { ... },
         "encryptionKeyType": "string"
      },
      "updatedAt": "string"
   }
}
```

## Response Elements
<a name="API_CreateRouterInput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [routerInput](#API_CreateRouterInput_ResponseSyntax) **   <a name="mediaconnect-CreateRouterInput-response-routerInput"></a>
The newly-created router input.  
Type: [RouterInput](API_RouterInput.md) object

## Errors
<a name="API_CreateRouterInput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** RouterInputServiceQuotaExceededException **   
The request to create a new router input would exceed the service quotas for the account.   
HTTP Status Code: 420

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_CreateRouterInput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/CreateRouterInput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/CreateRouterInput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/CreateRouterInput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/CreateRouterInput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/CreateRouterInput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/CreateRouterInput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/CreateRouterInput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/CreateRouterInput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/CreateRouterInput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/CreateRouterInput) 

# CreateRouterNetworkInterface
<a name="API_CreateRouterNetworkInterface"></a>

Creates a new router network interface in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_CreateRouterNetworkInterface_RequestSyntax"></a>

```
POST /v1/routerNetworkInterface HTTP/1.1
Content-type: application/json

{
   "clientToken": "string",
   "configuration": { ... },
   "name": "string",
   "regionName": "string",
   "tags": { 
      "string" : "string" 
   }
}
```

## URI Request Parameters
<a name="API_CreateRouterNetworkInterface_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateRouterNetworkInterface_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [clientToken](#API_CreateRouterNetworkInterface_RequestSyntax) **   <a name="mediaconnect-CreateRouterNetworkInterface-request-clientToken"></a>
A unique identifier for the request to ensure idempotency.  
Type: String  
Required: No

 ** [configuration](#API_CreateRouterNetworkInterface_RequestSyntax) **   <a name="mediaconnect-CreateRouterNetworkInterface-request-configuration"></a>
The configuration settings for the router network interface.  
Type: [RouterNetworkInterfaceConfiguration](API_RouterNetworkInterfaceConfiguration.md) object  
 **Note: **This object is a Union. Only one member of this object can be specified or returned.  
Required: Yes

 ** [name](#API_CreateRouterNetworkInterface_RequestSyntax) **   <a name="mediaconnect-CreateRouterNetworkInterface-request-name"></a>
The name of the router network interface.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Required: Yes

 ** [regionName](#API_CreateRouterNetworkInterface_RequestSyntax) **   <a name="mediaconnect-CreateRouterNetworkInterface-request-regionName"></a>
The AWS Region for the router network interface. Defaults to the current region if not specified.  
Type: String  
Required: No

 ** [tags](#API_CreateRouterNetworkInterface_RequestSyntax) **   <a name="mediaconnect-CreateRouterNetworkInterface-request-tags"></a>
Key-value pairs that can be used to tag and organize this router network interface.  
Type: String to string map  
Required: No

## Response Syntax
<a name="API_CreateRouterNetworkInterface_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "routerNetworkInterface": { 
      "arn": "string",
      "associatedInputCount": number,
      "associatedOutputCount": number,
      "configuration": { ... },
      "createdAt": "string",
      "id": "string",
      "name": "string",
      "networkInterfaceType": "string",
      "regionName": "string",
      "state": "string",
      "tags": { 
         "string" : "string" 
      },
      "updatedAt": "string"
   }
}
```

## Response Elements
<a name="API_CreateRouterNetworkInterface_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [routerNetworkInterface](#API_CreateRouterNetworkInterface_ResponseSyntax) **   <a name="mediaconnect-CreateRouterNetworkInterface-response-routerNetworkInterface"></a>
The newly-created router network interface.  
Type: [RouterNetworkInterface](API_RouterNetworkInterface.md) object

## Errors
<a name="API_CreateRouterNetworkInterface_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** RouterNetworkInterfaceServiceQuotaExceededException **   
The request to create a new router network interface would exceed the service quotas (limits) set for the account.   
HTTP Status Code: 420

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_CreateRouterNetworkInterface_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/CreateRouterNetworkInterface) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/CreateRouterNetworkInterface) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/CreateRouterNetworkInterface) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/CreateRouterNetworkInterface) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/CreateRouterNetworkInterface) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/CreateRouterNetworkInterface) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/CreateRouterNetworkInterface) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/CreateRouterNetworkInterface) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/CreateRouterNetworkInterface) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/CreateRouterNetworkInterface) 

# CreateRouterOutput
<a name="API_CreateRouterOutput"></a>

Creates a new router output in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_CreateRouterOutput_RequestSyntax"></a>

```
POST /v1/routerOutput HTTP/1.1
Content-type: application/json

{
   "availabilityZone": "string",
   "clientToken": "string",
   "configuration": { ... },
   "maintenanceConfiguration": { ... },
   "maximumBitrate": number,
   "name": "string",
   "regionName": "string",
   "routingScope": "string",
   "tags": { 
      "string" : "string" 
   },
   "tier": "string"
}
```

## URI Request Parameters
<a name="API_CreateRouterOutput_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateRouterOutput_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [availabilityZone](#API_CreateRouterOutput_RequestSyntax) **   <a name="mediaconnect-CreateRouterOutput-request-availabilityZone"></a>
The Availability Zone where you want to create the router output. This must be a valid Availability Zone for the region specified by `regionName`, or the current region if no `regionName` is provided.   
Type: String  
Required: No

 ** [clientToken](#API_CreateRouterOutput_RequestSyntax) **   <a name="mediaconnect-CreateRouterOutput-request-clientToken"></a>
A unique identifier for the request to ensure idempotency.  
Type: String  
Required: No

 ** [configuration](#API_CreateRouterOutput_RequestSyntax) **   <a name="mediaconnect-CreateRouterOutput-request-configuration"></a>
The configuration settings for the router output.  
Type: [RouterOutputConfiguration](API_RouterOutputConfiguration.md) object  
 **Note: **This object is a Union. Only one member of this object can be specified or returned.  
Required: Yes

 ** [maintenanceConfiguration](#API_CreateRouterOutput_RequestSyntax) **   <a name="mediaconnect-CreateRouterOutput-request-maintenanceConfiguration"></a>
The maintenance configuration settings for the router output, including preferred maintenance windows and schedules.  
Type: [MaintenanceConfiguration](API_MaintenanceConfiguration.md) object  
 **Note: **This object is a Union. Only one member of this object can be specified or returned.  
Required: No

 ** [maximumBitrate](#API_CreateRouterOutput_RequestSyntax) **   <a name="mediaconnect-CreateRouterOutput-request-maximumBitrate"></a>
The maximum bitrate for the router output.  
Type: Long  
Required: Yes

 ** [name](#API_CreateRouterOutput_RequestSyntax) **   <a name="mediaconnect-CreateRouterOutput-request-name"></a>
The name of the router output.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Required: Yes

 ** [regionName](#API_CreateRouterOutput_RequestSyntax) **   <a name="mediaconnect-CreateRouterOutput-request-regionName"></a>
The AWS Region for the router output. Defaults to the current region if not specified.  
Type: String  
Required: No

 ** [routingScope](#API_CreateRouterOutput_RequestSyntax) **   <a name="mediaconnect-CreateRouterOutput-request-routingScope"></a>
Specifies whether the router output can take inputs that are in different Regions. REGIONAL (default) - can only take inputs from same Region. GLOBAL - can take inputs from any Region.  
Type: String  
Valid Values: `REGIONAL | GLOBAL`   
Required: Yes

 ** [tags](#API_CreateRouterOutput_RequestSyntax) **   <a name="mediaconnect-CreateRouterOutput-request-tags"></a>
Key-value pairs that can be used to tag this router output.  
Type: String to string map  
Required: No

 ** [tier](#API_CreateRouterOutput_RequestSyntax) **   <a name="mediaconnect-CreateRouterOutput-request-tier"></a>
The tier level for the router output.  
Type: String  
Valid Values: `OUTPUT_100 | OUTPUT_50 | OUTPUT_20`   
Required: Yes

## Response Syntax
<a name="API_CreateRouterOutput_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "routerOutput": { 
      "arn": "string",
      "availabilityZone": "string",
      "configuration": { ... },
      "createdAt": "string",
      "id": "string",
      "ipAddress": "string",
      "maintenanceConfiguration": { ... },
      "maintenanceSchedule": { ... },
      "maintenanceScheduleType": "string",
      "maintenanceType": "string",
      "maximumBitrate": number,
      "messages": [ 
         { 
            "code": "string",
            "message": "string"
         }
      ],
      "name": "string",
      "outputType": "string",
      "regionName": "string",
      "routedInputArn": "string",
      "routedState": "string",
      "routingScope": "string",
      "state": "string",
      "streamDetails": { ... },
      "tags": { 
         "string" : "string" 
      },
      "tier": "string",
      "updatedAt": "string"
   }
}
```

## Response Elements
<a name="API_CreateRouterOutput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [routerOutput](#API_CreateRouterOutput_ResponseSyntax) **   <a name="mediaconnect-CreateRouterOutput-response-routerOutput"></a>
The newly-created router output.  
Type: [RouterOutput](API_RouterOutput.md) object

## Errors
<a name="API_CreateRouterOutput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** RouterOutputServiceQuotaExceededException **   
The request to create a new router output would exceed the service quotas (limits) set for the account.   
HTTP Status Code: 420

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_CreateRouterOutput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/CreateRouterOutput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/CreateRouterOutput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/CreateRouterOutput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/CreateRouterOutput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/CreateRouterOutput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/CreateRouterOutput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/CreateRouterOutput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/CreateRouterOutput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/CreateRouterOutput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/CreateRouterOutput) 

# DeleteBridge
<a name="API_DeleteBridge"></a>

 Deletes a bridge. Before you can delete a bridge, you must stop the bridge.

## Request Syntax
<a name="API_DeleteBridge_RequestSyntax"></a>

```
DELETE /v1/bridges/bridgeArn HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteBridge_RequestParameters"></a>

The request uses the following URI parameters.

 ** [bridgeArn](#API_DeleteBridge_RequestSyntax) **   <a name="mediaconnect-DeleteBridge-request-uri-bridgeArn"></a>
 The Amazon Resource Name (ARN) of the bridge that you want to delete.  
Pattern: `arn:.+:mediaconnect.+:bridge:.+`   
Required: Yes

## Request Body
<a name="API_DeleteBridge_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteBridge_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "bridgeArn": "string"
}
```

## Response Elements
<a name="API_DeleteBridge_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [bridgeArn](#API_DeleteBridge_ResponseSyntax) **   <a name="mediaconnect-DeleteBridge-response-bridgeArn"></a>
 The ARN of the deleted bridge.  
Type: String

## Errors
<a name="API_DeleteBridge_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DeleteBridge_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DeleteBridge) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DeleteBridge) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DeleteBridge) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DeleteBridge) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DeleteBridge) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DeleteBridge) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DeleteBridge) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DeleteBridge) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DeleteBridge) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DeleteBridge) 

# DeleteFlow
<a name="API_DeleteFlow"></a>

 Deletes a flow. Before you can delete a flow, you must stop the flow.

## Request Syntax
<a name="API_DeleteFlow_RequestSyntax"></a>

```
DELETE /v1/flows/flowArn HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteFlow_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_DeleteFlow_RequestSyntax) **   <a name="mediaconnect-DeleteFlow-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that you want to delete.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

## Request Body
<a name="API_DeleteFlow_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteFlow_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "flowArn": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_DeleteFlow_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_DeleteFlow_ResponseSyntax) **   <a name="mediaconnect-DeleteFlow-response-flowArn"></a>
 The ARN of the flow that was deleted.  
Type: String

 ** [status](#API_DeleteFlow_ResponseSyntax) **   <a name="mediaconnect-DeleteFlow-response-status"></a>
 The status of the flow when the `DeleteFlow` process begins.  
Type: String  
Valid Values: `STANDBY | ACTIVE | UPDATING | DELETING | STARTING | STOPPING | ERROR` 

## Errors
<a name="API_DeleteFlow_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DeleteFlow_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DeleteFlow) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DeleteFlow) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DeleteFlow) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DeleteFlow) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DeleteFlow) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DeleteFlow) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DeleteFlow) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DeleteFlow) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DeleteFlow) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DeleteFlow) 

# DeleteGateway
<a name="API_DeleteGateway"></a>

 Deletes a gateway. Before you can delete a gateway, you must deregister its instances and delete its bridges.

## Request Syntax
<a name="API_DeleteGateway_RequestSyntax"></a>

```
DELETE /v1/gateways/gatewayArn HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteGateway_RequestParameters"></a>

The request uses the following URI parameters.

 ** [gatewayArn](#API_DeleteGateway_RequestSyntax) **   <a name="mediaconnect-DeleteGateway-request-uri-gatewayArn"></a>
 The Amazon Resource Name (ARN) of the gateway that you want to delete.  
Pattern: `arn:.+:mediaconnect.+:gateway:.+`   
Required: Yes

## Request Body
<a name="API_DeleteGateway_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteGateway_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "gatewayArn": "string"
}
```

## Response Elements
<a name="API_DeleteGateway_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [gatewayArn](#API_DeleteGateway_ResponseSyntax) **   <a name="mediaconnect-DeleteGateway-response-gatewayArn"></a>
 The ARN of the gateway that was deleted.  
Type: String

## Errors
<a name="API_DeleteGateway_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DeleteGateway_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DeleteGateway) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DeleteGateway) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DeleteGateway) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DeleteGateway) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DeleteGateway) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DeleteGateway) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DeleteGateway) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DeleteGateway) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DeleteGateway) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DeleteGateway) 

# DeleteRouterInput
<a name="API_DeleteRouterInput"></a>

Deletes a router input from AWS Elemental MediaConnect.

## Request Syntax
<a name="API_DeleteRouterInput_RequestSyntax"></a>

```
DELETE /v1/routerInput/arn HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteRouterInput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_DeleteRouterInput_RequestSyntax) **   <a name="mediaconnect-DeleteRouterInput-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router input that you want to delete.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_DeleteRouterInput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteRouterInput_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "arn": "string",
   "name": "string",
   "state": "string"
}
```

## Response Elements
<a name="API_DeleteRouterInput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [arn](#API_DeleteRouterInput_ResponseSyntax) **   <a name="mediaconnect-DeleteRouterInput-response-arn"></a>
The ARN of the deleted router input.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}` 

 ** [name](#API_DeleteRouterInput_ResponseSyntax) **   <a name="mediaconnect-DeleteRouterInput-response-name"></a>
The name of the deleted router input.  
Type: String

 ** [state](#API_DeleteRouterInput_ResponseSyntax) **   <a name="mediaconnect-DeleteRouterInput-response-state"></a>
The current state of the deleted router input, indicating where it is in the deletion process.  
Type: String  
Valid Values: `CREATING | STANDBY | STARTING | ACTIVE | STOPPING | DELETING | UPDATING | ERROR | RECOVERING | MIGRATING` 

## Errors
<a name="API_DeleteRouterInput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DeleteRouterInput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DeleteRouterInput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DeleteRouterInput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DeleteRouterInput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DeleteRouterInput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DeleteRouterInput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DeleteRouterInput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DeleteRouterInput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DeleteRouterInput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DeleteRouterInput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DeleteRouterInput) 

# DeleteRouterNetworkInterface
<a name="API_DeleteRouterNetworkInterface"></a>

Deletes a router network interface from AWS Elemental MediaConnect.

## Request Syntax
<a name="API_DeleteRouterNetworkInterface_RequestSyntax"></a>

```
DELETE /v1/routerNetworkInterface/arn HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteRouterNetworkInterface_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_DeleteRouterNetworkInterface_RequestSyntax) **   <a name="mediaconnect-DeleteRouterNetworkInterface-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router network interface that you want to delete.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerNetworkInterface:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_DeleteRouterNetworkInterface_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteRouterNetworkInterface_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "arn": "string",
   "name": "string",
   "state": "string"
}
```

## Response Elements
<a name="API_DeleteRouterNetworkInterface_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [arn](#API_DeleteRouterNetworkInterface_ResponseSyntax) **   <a name="mediaconnect-DeleteRouterNetworkInterface-response-arn"></a>
The ARN of the deleted router network interface.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerNetworkInterface:[a-z0-9]{12}` 

 ** [name](#API_DeleteRouterNetworkInterface_ResponseSyntax) **   <a name="mediaconnect-DeleteRouterNetworkInterface-response-name"></a>
The name of the deleted router network interface.  
Type: String

 ** [state](#API_DeleteRouterNetworkInterface_ResponseSyntax) **   <a name="mediaconnect-DeleteRouterNetworkInterface-response-state"></a>
The current state of the deleted router network interface, indicating where it is in the deletion process.  
Type: String  
Valid Values: `CREATING | ACTIVE | UPDATING | DELETING | ERROR | RECOVERING` 

## Errors
<a name="API_DeleteRouterNetworkInterface_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DeleteRouterNetworkInterface_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DeleteRouterNetworkInterface) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DeleteRouterNetworkInterface) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DeleteRouterNetworkInterface) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DeleteRouterNetworkInterface) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DeleteRouterNetworkInterface) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DeleteRouterNetworkInterface) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DeleteRouterNetworkInterface) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DeleteRouterNetworkInterface) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DeleteRouterNetworkInterface) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DeleteRouterNetworkInterface) 

# DeleteRouterOutput
<a name="API_DeleteRouterOutput"></a>

Deletes a router output from AWS Elemental MediaConnect.

## Request Syntax
<a name="API_DeleteRouterOutput_RequestSyntax"></a>

```
DELETE /v1/routerOutput/arn HTTP/1.1
```

## URI Request Parameters
<a name="API_DeleteRouterOutput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_DeleteRouterOutput_RequestSyntax) **   <a name="mediaconnect-DeleteRouterOutput-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router output that you want to delete.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerOutput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_DeleteRouterOutput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeleteRouterOutput_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "arn": "string",
   "name": "string",
   "state": "string"
}
```

## Response Elements
<a name="API_DeleteRouterOutput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [arn](#API_DeleteRouterOutput_ResponseSyntax) **   <a name="mediaconnect-DeleteRouterOutput-response-arn"></a>
The ARN of the deleted router output.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerOutput:[a-z0-9]{12}` 

 ** [name](#API_DeleteRouterOutput_ResponseSyntax) **   <a name="mediaconnect-DeleteRouterOutput-response-name"></a>
The name of the deleted router output.  
Type: String

 ** [state](#API_DeleteRouterOutput_ResponseSyntax) **   <a name="mediaconnect-DeleteRouterOutput-response-state"></a>
The current state of the deleted router output, indicating where it is in the deletion process.  
Type: String  
Valid Values: `CREATING | STANDBY | STARTING | ACTIVE | STOPPING | DELETING | UPDATING | ERROR | RECOVERING | MIGRATING` 

## Errors
<a name="API_DeleteRouterOutput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DeleteRouterOutput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DeleteRouterOutput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DeleteRouterOutput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DeleteRouterOutput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DeleteRouterOutput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DeleteRouterOutput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DeleteRouterOutput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DeleteRouterOutput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DeleteRouterOutput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DeleteRouterOutput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DeleteRouterOutput) 

# DeregisterGatewayInstance
<a name="API_DeregisterGatewayInstance"></a>

 Deregisters an instance. Before you deregister an instance, all bridges running on the instance must be stopped. If you want to deregister an instance without stopping the bridges, you must use the --force option.

## Request Syntax
<a name="API_DeregisterGatewayInstance_RequestSyntax"></a>

```
DELETE /v1/gateway-instances/gatewayInstanceArn?force=force HTTP/1.1
```

## URI Request Parameters
<a name="API_DeregisterGatewayInstance_RequestParameters"></a>

The request uses the following URI parameters.

 ** [force](#API_DeregisterGatewayInstance_RequestSyntax) **   <a name="mediaconnect-DeregisterGatewayInstance-request-uri-force"></a>
 Force the deregistration of an instance. Force will deregister an instance, even if there are bridges running on it.

 ** [gatewayInstanceArn](#API_DeregisterGatewayInstance_RequestSyntax) **   <a name="mediaconnect-DeregisterGatewayInstance-request-uri-gatewayInstanceArn"></a>
 The Amazon Resource Name (ARN) of the gateway that contains the instance that you want to deregister.  
Pattern: `arn:.+:mediaconnect.+:gateway:.+:instance:.+`   
Required: Yes

## Request Body
<a name="API_DeregisterGatewayInstance_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DeregisterGatewayInstance_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "gatewayInstanceArn": "string",
   "instanceState": "string"
}
```

## Response Elements
<a name="API_DeregisterGatewayInstance_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [gatewayInstanceArn](#API_DeregisterGatewayInstance_ResponseSyntax) **   <a name="mediaconnect-DeregisterGatewayInstance-response-gatewayInstanceArn"></a>
 The ARN of the instance.  
Type: String

 ** [instanceState](#API_DeregisterGatewayInstance_ResponseSyntax) **   <a name="mediaconnect-DeregisterGatewayInstance-response-instanceState"></a>
 The status of the instance.  
Type: String  
Valid Values: `REGISTERING | ACTIVE | DEREGISTERING | DEREGISTERED | REGISTRATION_ERROR | DEREGISTRATION_ERROR` 

## Errors
<a name="API_DeregisterGatewayInstance_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DeregisterGatewayInstance_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DeregisterGatewayInstance) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DeregisterGatewayInstance) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DeregisterGatewayInstance) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DeregisterGatewayInstance) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DeregisterGatewayInstance) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DeregisterGatewayInstance) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DeregisterGatewayInstance) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DeregisterGatewayInstance) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DeregisterGatewayInstance) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DeregisterGatewayInstance) 

# DescribeBridge
<a name="API_DescribeBridge"></a>

 Displays the details of a bridge.

## Request Syntax
<a name="API_DescribeBridge_RequestSyntax"></a>

```
GET /v1/bridges/bridgeArn HTTP/1.1
```

## URI Request Parameters
<a name="API_DescribeBridge_RequestParameters"></a>

The request uses the following URI parameters.

 ** [bridgeArn](#API_DescribeBridge_RequestSyntax) **   <a name="mediaconnect-DescribeBridge-request-uri-bridgeArn"></a>
 The Amazon Resource Name (ARN) of the bridge that you want to describe.  
Pattern: `arn:.+:mediaconnect.+:bridge:.+`   
Required: Yes

## Request Body
<a name="API_DescribeBridge_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DescribeBridge_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "bridge": { 
      "bridgeArn": "string",
      "bridgeMessages": [ 
         { 
            "code": "string",
            "message": "string",
            "resourceName": "string"
         }
      ],
      "bridgeState": "string",
      "egressGatewayBridge": { 
         "instanceId": "string",
         "maxBitrate": number
      },
      "ingressGatewayBridge": { 
         "instanceId": "string",
         "maxBitrate": number,
         "maxOutputs": number
      },
      "name": "string",
      "outputs": [ 
         { 
            "flowOutput": { 
               "flowArn": "string",
               "flowSourceArn": "string",
               "name": "string"
            },
            "networkOutput": { 
               "ipAddress": "string",
               "name": "string",
               "networkName": "string",
               "port": number,
               "protocol": "string",
               "ttl": number
            }
         }
      ],
      "placementArn": "string",
      "sourceFailoverConfig": { 
         "failoverMode": "string",
         "recoveryWindow": number,
         "sourcePriority": { 
            "primarySource": "string"
         },
         "state": "string"
      },
      "sources": [ 
         { 
            "flowSource": { 
               "flowArn": "string",
               "flowVpcInterfaceAttachment": { 
                  "vpcInterfaceName": "string"
               },
               "name": "string",
               "outputArn": "string"
            },
            "networkSource": { 
               "multicastIp": "string",
               "multicastSourceSettings": { 
                  "multicastSourceIp": "string"
               },
               "name": "string",
               "networkName": "string",
               "port": number,
               "protocol": "string"
            }
         }
      ]
   }
}
```

## Response Elements
<a name="API_DescribeBridge_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [bridge](#API_DescribeBridge_ResponseSyntax) **   <a name="mediaconnect-DescribeBridge-response-bridge"></a>
The bridge that you requested a description of.   
Type: [Bridge](API_Bridge.md) object

## Errors
<a name="API_DescribeBridge_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DescribeBridge_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DescribeBridge) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DescribeBridge) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DescribeBridge) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DescribeBridge) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DescribeBridge) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DescribeBridge) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DescribeBridge) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DescribeBridge) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DescribeBridge) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DescribeBridge) 

# DescribeFlow
<a name="API_DescribeFlow"></a>

 Displays the details of a flow. The response includes the flow Amazon Resource Name (ARN), name, and Availability Zone, as well as details about the source, outputs, and entitlements.

## Request Syntax
<a name="API_DescribeFlow_RequestSyntax"></a>

```
GET /v1/flows/flowArn HTTP/1.1
```

## URI Request Parameters
<a name="API_DescribeFlow_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_DescribeFlow_RequestSyntax) **   <a name="mediaconnect-DescribeFlow-request-uri-flowArn"></a>
 The ARN of the flow that you want to describe.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

## Request Body
<a name="API_DescribeFlow_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DescribeFlow_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "flow": { 
      "availabilityZone": "string",
      "description": "string",
      "egressIp": "string",
      "encodingConfig": { 
         "encodingProfile": "string",
         "videoMaxBitrate": number
      },
      "entitlements": [ 
         { 
            "dataTransferSubscriberFeePercent": number,
            "description": "string",
            "encryption": { 
               "algorithm": "string",
               "constantInitializationVector": "string",
               "deviceId": "string",
               "keyType": "string",
               "region": "string",
               "resourceId": "string",
               "roleArn": "string",
               "secretArn": "string",
               "url": "string"
            },
            "entitlementArn": "string",
            "entitlementStatus": "string",
            "name": "string",
            "subscribers": [ "string" ]
         }
      ],
      "flowArn": "string",
      "flowSize": "string",
      "maintenance": { 
         "maintenanceDay": "string",
         "maintenanceDeadline": "string",
         "maintenanceScheduledDate": "string",
         "maintenanceStartHour": "string"
      },
      "mediaStreams": [ 
         { 
            "attributes": { 
               "fmtp": { 
                  "channelOrder": "string",
                  "colorimetry": "string",
                  "exactFramerate": "string",
                  "par": "string",
                  "range": "string",
                  "scanMode": "string",
                  "tcs": "string"
               },
               "lang": "string"
            },
            "clockRate": number,
            "description": "string",
            "fmt": number,
            "mediaStreamId": number,
            "mediaStreamName": "string",
            "mediaStreamType": "string",
            "videoFormat": "string"
         }
      ],
      "name": "string",
      "ndiConfig": { 
         "machineName": "string",
         "ndiDiscoveryServers": [ 
            { 
               "discoveryServerAddress": "string",
               "discoveryServerPort": number,
               "vpcInterfaceAdapter": "string"
            }
         ],
         "ndiState": "string"
      },
      "outputs": [ 
         { 
            "bridgeArn": "string",
            "bridgePorts": [ number ],
            "connectedRouterInputArn": "string",
            "dataTransferSubscriberFeePercent": number,
            "description": "string",
            "destination": "string",
            "encryption": { 
               "algorithm": "string",
               "constantInitializationVector": "string",
               "deviceId": "string",
               "keyType": "string",
               "region": "string",
               "resourceId": "string",
               "roleArn": "string",
               "secretArn": "string",
               "url": "string"
            },
            "entitlementArn": "string",
            "listenerAddress": "string",
            "mediaLiveInputArn": "string",
            "mediaStreamOutputConfigurations": [ 
               { 
                  "destinationConfigurations": [ 
                     { 
                        "destinationIp": "string",
                        "destinationPort": number,
                        "interface": { 
                           "name": "string"
                        },
                        "outboundIp": "string"
                     }
                  ],
                  "encodingName": "string",
                  "encodingParameters": { 
                     "compressionFactor": number,
                     "encoderProfile": "string"
                  },
                  "mediaStreamName": "string"
               }
            ],
            "name": "string",
            "outputArn": "string",
            "outputStatus": "string",
            "peerIpAddress": "string",
            "port": number,
            "routerIntegrationState": "string",
            "routerIntegrationTransitEncryption": { 
               "encryptionKeyConfiguration": { ... },
               "encryptionKeyType": "string"
            },
            "transport": { 
               "cidrAllowList": [ "string" ],
               "maxBitrate": number,
               "maxLatency": number,
               "maxSyncBuffer": number,
               "minLatency": number,
               "ndiProgramName": "string",
               "ndiSourceSettings": { 
                  "sourceName": "string"
               },
               "ndiSpeedHqQuality": number,
               "protocol": "string",
               "remoteId": "string",
               "senderControlPort": number,
               "senderIpAddress": "string",
               "smoothingLatency": number,
               "sourceListenerAddress": "string",
               "sourceListenerPort": number,
               "streamId": "string"
            },
            "vpcInterfaceAttachment": { 
               "vpcInterfaceName": "string"
            }
         }
      ],
      "source": { 
         "connectedRouterOutputArn": "string",
         "dataTransferSubscriberFeePercent": number,
         "decryption": { 
            "algorithm": "string",
            "constantInitializationVector": "string",
            "deviceId": "string",
            "keyType": "string",
            "region": "string",
            "resourceId": "string",
            "roleArn": "string",
            "secretArn": "string",
            "url": "string"
         },
         "description": "string",
         "entitlementArn": "string",
         "gatewayBridgeSource": { 
            "bridgeArn": "string",
            "vpcInterfaceAttachment": { 
               "vpcInterfaceName": "string"
            }
         },
         "ingestIp": "string",
         "ingestPort": number,
         "mediaStreamSourceConfigurations": [ 
            { 
               "encodingName": "string",
               "inputConfigurations": [ 
                  { 
                     "inputIp": "string",
                     "inputPort": number,
                     "interface": { 
                        "name": "string"
                     }
                  }
               ],
               "mediaStreamName": "string"
            }
         ],
         "name": "string",
         "peerIpAddress": "string",
         "routerIntegrationState": "string",
         "routerIntegrationTransitDecryption": { 
            "encryptionKeyConfiguration": { ... },
            "encryptionKeyType": "string"
         },
         "senderControlPort": number,
         "senderIpAddress": "string",
         "sourceArn": "string",
         "transport": { 
            "cidrAllowList": [ "string" ],
            "maxBitrate": number,
            "maxLatency": number,
            "maxSyncBuffer": number,
            "minLatency": number,
            "ndiProgramName": "string",
            "ndiSourceSettings": { 
               "sourceName": "string"
            },
            "ndiSpeedHqQuality": number,
            "protocol": "string",
            "remoteId": "string",
            "senderControlPort": number,
            "senderIpAddress": "string",
            "smoothingLatency": number,
            "sourceListenerAddress": "string",
            "sourceListenerPort": number,
            "streamId": "string"
         },
         "vpcInterfaceName": "string",
         "whitelistCidr": "string"
      },
      "sourceFailoverConfig": { 
         "failoverMode": "string",
         "recoveryWindow": number,
         "sourcePriority": { 
            "primarySource": "string"
         },
         "state": "string"
      },
      "sourceMonitoringConfig": { 
         "audioMonitoringSettings": [ 
            { 
               "silentAudio": { 
                  "state": "string",
                  "thresholdSeconds": number
               }
            }
         ],
         "contentQualityAnalysisState": "string",
         "thumbnailState": "string",
         "videoMonitoringSettings": [ 
            { 
               "blackFrames": { 
                  "state": "string",
                  "thresholdSeconds": number
               },
               "frozenFrames": { 
                  "state": "string",
                  "thresholdSeconds": number
               }
            }
         ]
      },
      "sources": [ 
         { 
            "connectedRouterOutputArn": "string",
            "dataTransferSubscriberFeePercent": number,
            "decryption": { 
               "algorithm": "string",
               "constantInitializationVector": "string",
               "deviceId": "string",
               "keyType": "string",
               "region": "string",
               "resourceId": "string",
               "roleArn": "string",
               "secretArn": "string",
               "url": "string"
            },
            "description": "string",
            "entitlementArn": "string",
            "gatewayBridgeSource": { 
               "bridgeArn": "string",
               "vpcInterfaceAttachment": { 
                  "vpcInterfaceName": "string"
               }
            },
            "ingestIp": "string",
            "ingestPort": number,
            "mediaStreamSourceConfigurations": [ 
               { 
                  "encodingName": "string",
                  "inputConfigurations": [ 
                     { 
                        "inputIp": "string",
                        "inputPort": number,
                        "interface": { 
                           "name": "string"
                        }
                     }
                  ],
                  "mediaStreamName": "string"
               }
            ],
            "name": "string",
            "peerIpAddress": "string",
            "routerIntegrationState": "string",
            "routerIntegrationTransitDecryption": { 
               "encryptionKeyConfiguration": { ... },
               "encryptionKeyType": "string"
            },
            "senderControlPort": number,
            "senderIpAddress": "string",
            "sourceArn": "string",
            "transport": { 
               "cidrAllowList": [ "string" ],
               "maxBitrate": number,
               "maxLatency": number,
               "maxSyncBuffer": number,
               "minLatency": number,
               "ndiProgramName": "string",
               "ndiSourceSettings": { 
                  "sourceName": "string"
               },
               "ndiSpeedHqQuality": number,
               "protocol": "string",
               "remoteId": "string",
               "senderControlPort": number,
               "senderIpAddress": "string",
               "smoothingLatency": number,
               "sourceListenerAddress": "string",
               "sourceListenerPort": number,
               "streamId": "string"
            },
            "vpcInterfaceName": "string",
            "whitelistCidr": "string"
         }
      ],
      "status": "string",
      "vpcInterfaces": [ 
         { 
            "name": "string",
            "networkInterfaceIds": [ "string" ],
            "networkInterfaceType": "string",
            "roleArn": "string",
            "securityGroupIds": [ "string" ],
            "subnetId": "string"
         }
      ]
   },
   "messages": { 
      "errors": [ "string" ]
   }
}
```

## Response Elements
<a name="API_DescribeFlow_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [flow](#API_DescribeFlow_ResponseSyntax) **   <a name="mediaconnect-DescribeFlow-response-flow"></a>
The flow that you requested a description of.   
Type: [Flow](API_Flow.md) object

 ** [messages](#API_DescribeFlow_ResponseSyntax) **   <a name="mediaconnect-DescribeFlow-response-messages"></a>
 Any errors that apply currently to the flow. If there are no errors, MediaConnect will not include this field in the response.   
Type: [Messages](API_Messages.md) object

## Errors
<a name="API_DescribeFlow_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DescribeFlow_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DescribeFlow) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DescribeFlow) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DescribeFlow) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DescribeFlow) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DescribeFlow) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DescribeFlow) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DescribeFlow) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DescribeFlow) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DescribeFlow) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DescribeFlow) 

# DescribeFlowSourceMetadata
<a name="API_DescribeFlowSourceMetadata"></a>

 The `DescribeFlowSourceMetadata` API is used to view information about the flow's source transport stream and programs. This API displays status messages about the flow's source as well as details about the program's video, audio, and other data. 

## Request Syntax
<a name="API_DescribeFlowSourceMetadata_RequestSyntax"></a>

```
GET /v1/flows/flowArn/source-metadata HTTP/1.1
```

## URI Request Parameters
<a name="API_DescribeFlowSourceMetadata_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_DescribeFlowSourceMetadata_RequestSyntax) **   <a name="mediaconnect-DescribeFlowSourceMetadata-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:flow:[a-zA-Z0-9-]+:[a-zA-Z0-9_-]+`   
Required: Yes

## Request Body
<a name="API_DescribeFlowSourceMetadata_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DescribeFlowSourceMetadata_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "flowArn": "string",
   "messages": [ 
      { 
         "code": "string",
         "message": "string",
         "resourceName": "string"
      }
   ],
   "ndiInfo": { 
      "activeSource": { 
         "sourceName": "string"
      },
      "discoveredSources": [ 
         { 
            "sourceName": "string"
         }
      ],
      "mediaInfo": { 
         "streams": [ 
            { 
               "channels": number,
               "codec": "string",
               "frameRate": "string",
               "frameResolution": { 
                  "frameHeight": number,
                  "frameWidth": number
               },
               "sampleRate": number,
               "scanMode": "string",
               "streamId": number,
               "streamType": "string"
            }
         ]
      },
      "messages": [ 
         { 
            "code": "string",
            "message": "string",
            "resourceName": "string"
         }
      ]
   },
   "timestamp": "string",
   "transportMediaInfo": { 
      "programs": [ 
         { 
            "pcrPid": number,
            "programName": "string",
            "programNumber": number,
            "programPid": number,
            "streams": [ 
               { 
                  "channels": number,
                  "codec": "string",
                  "frameRate": "string",
                  "frameResolution": { 
                     "frameHeight": number,
                     "frameWidth": number
                  },
                  "pid": number,
                  "sampleRate": number,
                  "sampleSize": number,
                  "streamType": "string"
               }
            ]
         }
      ]
   }
}
```

## Response Elements
<a name="API_DescribeFlowSourceMetadata_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_DescribeFlowSourceMetadata_ResponseSyntax) **   <a name="mediaconnect-DescribeFlowSourceMetadata-response-flowArn"></a>
 The ARN of the flow that DescribeFlowSourceMetadata was performed on.  
Type: String

 ** [messages](#API_DescribeFlowSourceMetadata_ResponseSyntax) **   <a name="mediaconnect-DescribeFlowSourceMetadata-response-messages"></a>
 Provides a status code and message regarding issues found with the flow source metadata.  
Type: Array of [MessageDetail](API_MessageDetail.md) objects

 ** [ndiInfo](#API_DescribeFlowSourceMetadata_ResponseSyntax) **   <a name="mediaconnect-DescribeFlowSourceMetadata-response-ndiInfo"></a>
 The NDI® specific information about the flow's source. This includes the current active NDI sender, a list of all discovered NDI senders, the associated media streams for the active NDI sender, and any relevant status messages.   
Type: [NdiSourceMetadataInfo](API_NdiSourceMetadataInfo.md) object

 ** [timestamp](#API_DescribeFlowSourceMetadata_ResponseSyntax) **   <a name="mediaconnect-DescribeFlowSourceMetadata-response-timestamp"></a>
 The timestamp of the most recent change in metadata for this flow’s source.  
Type: Timestamp

 ** [transportMediaInfo](#API_DescribeFlowSourceMetadata_ResponseSyntax) **   <a name="mediaconnect-DescribeFlowSourceMetadata-response-transportMediaInfo"></a>
 Information about the flow's transport media.   
Type: [TransportMediaInfo](API_TransportMediaInfo.md) object

## Errors
<a name="API_DescribeFlowSourceMetadata_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DescribeFlowSourceMetadata_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DescribeFlowSourceMetadata) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DescribeFlowSourceMetadata) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DescribeFlowSourceMetadata) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DescribeFlowSourceMetadata) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DescribeFlowSourceMetadata) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DescribeFlowSourceMetadata) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DescribeFlowSourceMetadata) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DescribeFlowSourceMetadata) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DescribeFlowSourceMetadata) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DescribeFlowSourceMetadata) 

# DescribeFlowSourceThumbnail
<a name="API_DescribeFlowSourceThumbnail"></a>

 Describes the thumbnail for the flow source. 

## Request Syntax
<a name="API_DescribeFlowSourceThumbnail_RequestSyntax"></a>

```
GET /v1/flows/flowArn/source-thumbnail HTTP/1.1
```

## URI Request Parameters
<a name="API_DescribeFlowSourceThumbnail_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_DescribeFlowSourceThumbnail_RequestSyntax) **   <a name="mediaconnect-DescribeFlowSourceThumbnail-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:flow:[a-zA-Z0-9-]+:[a-zA-Z0-9_-]+`   
Required: Yes

## Request Body
<a name="API_DescribeFlowSourceThumbnail_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DescribeFlowSourceThumbnail_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "thumbnailDetails": { 
      "flowArn": "string",
      "thumbnail": "string",
      "thumbnailMessages": [ 
         { 
            "code": "string",
            "message": "string",
            "resourceName": "string"
         }
      ],
      "timecode": "string",
      "timestamp": "string"
   }
}
```

## Response Elements
<a name="API_DescribeFlowSourceThumbnail_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [thumbnailDetails](#API_DescribeFlowSourceThumbnail_ResponseSyntax) **   <a name="mediaconnect-DescribeFlowSourceThumbnail-response-thumbnailDetails"></a>
The details of the thumbnail, including thumbnail base64 string, timecode and the time when thumbnail was generated.   
Type: [ThumbnailDetails](API_ThumbnailDetails.md) object

## Errors
<a name="API_DescribeFlowSourceThumbnail_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DescribeFlowSourceThumbnail_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DescribeFlowSourceThumbnail) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DescribeFlowSourceThumbnail) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DescribeFlowSourceThumbnail) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DescribeFlowSourceThumbnail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DescribeFlowSourceThumbnail) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DescribeFlowSourceThumbnail) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DescribeFlowSourceThumbnail) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DescribeFlowSourceThumbnail) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DescribeFlowSourceThumbnail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DescribeFlowSourceThumbnail) 

# DescribeGateway
<a name="API_DescribeGateway"></a>

 Displays the details of a gateway. The response includes the gateway Amazon Resource Name (ARN), name, and CIDR blocks, as well as details about the networks.

## Request Syntax
<a name="API_DescribeGateway_RequestSyntax"></a>

```
GET /v1/gateways/gatewayArn HTTP/1.1
```

## URI Request Parameters
<a name="API_DescribeGateway_RequestParameters"></a>

The request uses the following URI parameters.

 ** [gatewayArn](#API_DescribeGateway_RequestSyntax) **   <a name="mediaconnect-DescribeGateway-request-uri-gatewayArn"></a>
 The ARN of the gateway that you want to describe.  
Pattern: `arn:.+:mediaconnect.+:gateway:.+`   
Required: Yes

## Request Body
<a name="API_DescribeGateway_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DescribeGateway_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "gateway": { 
      "egressCidrBlocks": [ "string" ],
      "gatewayArn": "string",
      "gatewayMessages": [ 
         { 
            "code": "string",
            "message": "string",
            "resourceName": "string"
         }
      ],
      "gatewayState": "string",
      "name": "string",
      "networks": [ 
         { 
            "cidrBlock": "string",
            "name": "string"
         }
      ]
   }
}
```

## Response Elements
<a name="API_DescribeGateway_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [gateway](#API_DescribeGateway_ResponseSyntax) **   <a name="mediaconnect-DescribeGateway-response-gateway"></a>
The gateway that you wanted to describe.   
Type: [Gateway](API_Gateway.md) object

## Errors
<a name="API_DescribeGateway_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DescribeGateway_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DescribeGateway) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DescribeGateway) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DescribeGateway) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DescribeGateway) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DescribeGateway) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DescribeGateway) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DescribeGateway) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DescribeGateway) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DescribeGateway) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DescribeGateway) 

# DescribeGatewayInstance
<a name="API_DescribeGatewayInstance"></a>

 Displays the details of an instance. 

## Request Syntax
<a name="API_DescribeGatewayInstance_RequestSyntax"></a>

```
GET /v1/gateway-instances/gatewayInstanceArn HTTP/1.1
```

## URI Request Parameters
<a name="API_DescribeGatewayInstance_RequestParameters"></a>

The request uses the following URI parameters.

 ** [gatewayInstanceArn](#API_DescribeGatewayInstance_RequestSyntax) **   <a name="mediaconnect-DescribeGatewayInstance-request-uri-gatewayInstanceArn"></a>
 The Amazon Resource Name (ARN) of the gateway instance that you want to describe.  
Pattern: `arn:.+:mediaconnect.+:gateway:.+:instance:.+`   
Required: Yes

## Request Body
<a name="API_DescribeGatewayInstance_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DescribeGatewayInstance_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "gatewayInstance": { 
      "bridgePlacement": "string",
      "connectionStatus": "string",
      "gatewayArn": "string",
      "gatewayInstanceArn": "string",
      "instanceId": "string",
      "instanceMessages": [ 
         { 
            "code": "string",
            "message": "string",
            "resourceName": "string"
         }
      ],
      "instanceState": "string",
      "runningBridgeCount": number
   }
}
```

## Response Elements
<a name="API_DescribeGatewayInstance_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [gatewayInstance](#API_DescribeGatewayInstance_ResponseSyntax) **   <a name="mediaconnect-DescribeGatewayInstance-response-gatewayInstance"></a>
The gateway instance that you requested a description of.   
Type: [GatewayInstance](API_GatewayInstance.md) object

## Errors
<a name="API_DescribeGatewayInstance_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DescribeGatewayInstance_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DescribeGatewayInstance) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DescribeGatewayInstance) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DescribeGatewayInstance) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DescribeGatewayInstance) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DescribeGatewayInstance) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DescribeGatewayInstance) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DescribeGatewayInstance) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DescribeGatewayInstance) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DescribeGatewayInstance) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DescribeGatewayInstance) 

# DescribeOffering
<a name="API_DescribeOffering"></a>

 Displays the details of an offering. The response includes the offering description, duration, outbound bandwidth, price, and Amazon Resource Name (ARN).

## Request Syntax
<a name="API_DescribeOffering_RequestSyntax"></a>

```
GET /v1/offerings/offeringArn HTTP/1.1
```

## URI Request Parameters
<a name="API_DescribeOffering_RequestParameters"></a>

The request uses the following URI parameters.

 ** [offeringArn](#API_DescribeOffering_RequestSyntax) **   <a name="mediaconnect-DescribeOffering-request-uri-offeringArn"></a>
 The ARN of the offering.  
Required: Yes

## Request Body
<a name="API_DescribeOffering_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DescribeOffering_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "offering": { 
      "currencyCode": "string",
      "duration": number,
      "durationUnits": "string",
      "offeringArn": "string",
      "offeringDescription": "string",
      "pricePerUnit": "string",
      "priceUnits": "string",
      "resourceSpecification": { 
         "reservedBitrate": number,
         "resourceType": "string"
      }
   }
}
```

## Response Elements
<a name="API_DescribeOffering_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [offering](#API_DescribeOffering_ResponseSyntax) **   <a name="mediaconnect-DescribeOffering-response-offering"></a>
The offering that you requested a description of.   
Type: [Offering](API_Offering.md) object

## Errors
<a name="API_DescribeOffering_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DescribeOffering_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DescribeOffering) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DescribeOffering) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DescribeOffering) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DescribeOffering) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DescribeOffering) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DescribeOffering) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DescribeOffering) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DescribeOffering) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DescribeOffering) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DescribeOffering) 

# DescribeReservation
<a name="API_DescribeReservation"></a>

 Displays the details of a reservation. The response includes the reservation name, state, start date and time, and the details of the offering that make up the rest of the reservation (such as price, duration, and outbound bandwidth).

## Request Syntax
<a name="API_DescribeReservation_RequestSyntax"></a>

```
GET /v1/reservations/reservationArn HTTP/1.1
```

## URI Request Parameters
<a name="API_DescribeReservation_RequestParameters"></a>

The request uses the following URI parameters.

 ** [reservationArn](#API_DescribeReservation_RequestSyntax) **   <a name="mediaconnect-DescribeReservation-request-uri-reservationArn"></a>
The Amazon Resource Name (ARN) of the offering.   
Required: Yes

## Request Body
<a name="API_DescribeReservation_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_DescribeReservation_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "reservation": { 
      "currencyCode": "string",
      "duration": number,
      "durationUnits": "string",
      "end": "string",
      "offeringArn": "string",
      "offeringDescription": "string",
      "pricePerUnit": "string",
      "priceUnits": "string",
      "reservationArn": "string",
      "reservationName": "string",
      "reservationState": "string",
      "resourceSpecification": { 
         "reservedBitrate": number,
         "resourceType": "string"
      },
      "start": "string"
   }
}
```

## Response Elements
<a name="API_DescribeReservation_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [reservation](#API_DescribeReservation_ResponseSyntax) **   <a name="mediaconnect-DescribeReservation-response-reservation"></a>
 A pricing agreement for a discounted rate for a specific outbound bandwidth that your MediaConnect account will use each month over a specific time period. The discounted rate in the reservation applies to outbound bandwidth for all flows from your account until your account reaches the amount of bandwidth in your reservation. If you use more outbound bandwidth than the agreed upon amount in a single month, the overage is charged at the on-demand rate.   
Type: [Reservation](API_Reservation.md) object

## Errors
<a name="API_DescribeReservation_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_DescribeReservation_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/DescribeReservation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/DescribeReservation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/DescribeReservation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/DescribeReservation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/DescribeReservation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/DescribeReservation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/DescribeReservation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/DescribeReservation) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/DescribeReservation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/DescribeReservation) 

# GetRouterInput
<a name="API_GetRouterInput"></a>

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

## Request Syntax
<a name="API_GetRouterInput_RequestSyntax"></a>

```
GET /v1/routerInput/arn HTTP/1.1
```

## URI Request Parameters
<a name="API_GetRouterInput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_GetRouterInput_RequestSyntax) **   <a name="mediaconnect-GetRouterInput-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router input to retrieve information about.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_GetRouterInput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetRouterInput_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "routerInput": { 
      "arn": "string",
      "availabilityZone": "string",
      "configuration": { ... },
      "createdAt": "string",
      "id": "string",
      "inputType": "string",
      "ipAddress": "string",
      "maintenanceConfiguration": { ... },
      "maintenanceSchedule": { ... },
      "maintenanceScheduleType": "string",
      "maintenanceType": "string",
      "maximumBitrate": number,
      "maximumRoutedOutputs": number,
      "messages": [ 
         { 
            "code": "string",
            "message": "string"
         }
      ],
      "name": "string",
      "regionName": "string",
      "routedOutputs": number,
      "routingScope": "string",
      "state": "string",
      "streamDetails": { ... },
      "tags": { 
         "string" : "string" 
      },
      "tier": "string",
      "transitEncryption": { 
         "encryptionKeyConfiguration": { ... },
         "encryptionKeyType": "string"
      },
      "updatedAt": "string"
   }
}
```

## Response Elements
<a name="API_GetRouterInput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [routerInput](#API_GetRouterInput_ResponseSyntax) **   <a name="mediaconnect-GetRouterInput-response-routerInput"></a>
The details of the requested router input, including its configuration, state, and other attributes.  
Type: [RouterInput](API_RouterInput.md) object

## Errors
<a name="API_GetRouterInput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_GetRouterInput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/GetRouterInput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/GetRouterInput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/GetRouterInput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/GetRouterInput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/GetRouterInput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/GetRouterInput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/GetRouterInput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/GetRouterInput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/GetRouterInput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/GetRouterInput) 

# GetRouterInputSourceMetadata
<a name="API_GetRouterInputSourceMetadata"></a>

Retrieves detailed metadata information about a specific router input source, including stream details and connection state.

## Request Syntax
<a name="API_GetRouterInputSourceMetadata_RequestSyntax"></a>

```
GET /v1/routerInput/arn/source-metadata HTTP/1.1
```

## URI Request Parameters
<a name="API_GetRouterInputSourceMetadata_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_GetRouterInputSourceMetadata_RequestSyntax) **   <a name="mediaconnect-GetRouterInputSourceMetadata-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router input to retrieve metadata for.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_GetRouterInputSourceMetadata_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetRouterInputSourceMetadata_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "arn": "string",
   "name": "string",
   "sourceMetadataDetails": { 
      "routerInputMetadata": { ... },
      "sourceMetadataMessages": [ 
         { 
            "code": "string",
            "message": "string"
         }
      ],
      "timestamp": "string"
   }
}
```

## Response Elements
<a name="API_GetRouterInputSourceMetadata_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [arn](#API_GetRouterInputSourceMetadata_ResponseSyntax) **   <a name="mediaconnect-GetRouterInputSourceMetadata-response-arn"></a>
The Amazon Resource Name (ARN) of the router input.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}` 

 ** [name](#API_GetRouterInputSourceMetadata_ResponseSyntax) **   <a name="mediaconnect-GetRouterInputSourceMetadata-response-name"></a>
The name of the router input.  
Type: String

 ** [sourceMetadataDetails](#API_GetRouterInputSourceMetadata_ResponseSyntax) **   <a name="mediaconnect-GetRouterInputSourceMetadata-response-sourceMetadataDetails"></a>
Detailed metadata information about the router input source, including connection state, timestamps, and stream configuration.  
Type: [RouterInputSourceMetadataDetails](API_RouterInputSourceMetadataDetails.md) object

## Errors
<a name="API_GetRouterInputSourceMetadata_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_GetRouterInputSourceMetadata_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/GetRouterInputSourceMetadata) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/GetRouterInputSourceMetadata) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/GetRouterInputSourceMetadata) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/GetRouterInputSourceMetadata) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/GetRouterInputSourceMetadata) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/GetRouterInputSourceMetadata) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/GetRouterInputSourceMetadata) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/GetRouterInputSourceMetadata) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/GetRouterInputSourceMetadata) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/GetRouterInputSourceMetadata) 

# GetRouterInputThumbnail
<a name="API_GetRouterInputThumbnail"></a>

Retrieves the thumbnail for a router input in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_GetRouterInputThumbnail_RequestSyntax"></a>

```
GET /v1/routerInput/arn/thumbnail HTTP/1.1
```

## URI Request Parameters
<a name="API_GetRouterInputThumbnail_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_GetRouterInputThumbnail_RequestSyntax) **   <a name="mediaconnect-GetRouterInputThumbnail-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router input that you want to see a thumbnail of.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_GetRouterInputThumbnail_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetRouterInputThumbnail_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "arn": "string",
   "name": "string",
   "thumbnailDetails": { 
      "thumbnail": blob,
      "thumbnailMessages": [ 
         { 
            "code": "string",
            "message": "string"
         }
      ],
      "timecode": "string",
      "timestamp": "string"
   }
}
```

## Response Elements
<a name="API_GetRouterInputThumbnail_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [arn](#API_GetRouterInputThumbnail_ResponseSyntax) **   <a name="mediaconnect-GetRouterInputThumbnail-response-arn"></a>
The ARN of the router input.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}` 

 ** [name](#API_GetRouterInputThumbnail_ResponseSyntax) **   <a name="mediaconnect-GetRouterInputThumbnail-response-name"></a>
The name of the router input.  
Type: String

 ** [thumbnailDetails](#API_GetRouterInputThumbnail_ResponseSyntax) **   <a name="mediaconnect-GetRouterInputThumbnail-response-thumbnailDetails"></a>
The details of the thumbnail associated with the router input, including the thumbnail image, timecode, timestamp, and any associated error messages.  
Type: [RouterInputThumbnailDetails](API_RouterInputThumbnailDetails.md) object

## Errors
<a name="API_GetRouterInputThumbnail_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_GetRouterInputThumbnail_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/GetRouterInputThumbnail) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/GetRouterInputThumbnail) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/GetRouterInputThumbnail) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/GetRouterInputThumbnail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/GetRouterInputThumbnail) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/GetRouterInputThumbnail) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/GetRouterInputThumbnail) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/GetRouterInputThumbnail) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/GetRouterInputThumbnail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/GetRouterInputThumbnail) 

# GetRouterNetworkInterface
<a name="API_GetRouterNetworkInterface"></a>

Retrieves information about a specific router network interface in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_GetRouterNetworkInterface_RequestSyntax"></a>

```
GET /v1/routerNetworkInterface/arn HTTP/1.1
```

## URI Request Parameters
<a name="API_GetRouterNetworkInterface_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_GetRouterNetworkInterface_RequestSyntax) **   <a name="mediaconnect-GetRouterNetworkInterface-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router network interface that you want to retrieve information about.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerNetworkInterface:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_GetRouterNetworkInterface_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetRouterNetworkInterface_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "routerNetworkInterface": { 
      "arn": "string",
      "associatedInputCount": number,
      "associatedOutputCount": number,
      "configuration": { ... },
      "createdAt": "string",
      "id": "string",
      "name": "string",
      "networkInterfaceType": "string",
      "regionName": "string",
      "state": "string",
      "tags": { 
         "string" : "string" 
      },
      "updatedAt": "string"
   }
}
```

## Response Elements
<a name="API_GetRouterNetworkInterface_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [routerNetworkInterface](#API_GetRouterNetworkInterface_ResponseSyntax) **   <a name="mediaconnect-GetRouterNetworkInterface-response-routerNetworkInterface"></a>
The details of the requested router network interface, including its configuration and other attributes.  
Type: [RouterNetworkInterface](API_RouterNetworkInterface.md) object

## Errors
<a name="API_GetRouterNetworkInterface_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_GetRouterNetworkInterface_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/GetRouterNetworkInterface) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/GetRouterNetworkInterface) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/GetRouterNetworkInterface) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/GetRouterNetworkInterface) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/GetRouterNetworkInterface) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/GetRouterNetworkInterface) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/GetRouterNetworkInterface) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/GetRouterNetworkInterface) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/GetRouterNetworkInterface) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/GetRouterNetworkInterface) 

# GetRouterOutput
<a name="API_GetRouterOutput"></a>

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

## Request Syntax
<a name="API_GetRouterOutput_RequestSyntax"></a>

```
GET /v1/routerOutput/arn HTTP/1.1
```

## URI Request Parameters
<a name="API_GetRouterOutput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_GetRouterOutput_RequestSyntax) **   <a name="mediaconnect-GetRouterOutput-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router output that you want to retrieve information about.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerOutput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_GetRouterOutput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_GetRouterOutput_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "routerOutput": { 
      "arn": "string",
      "availabilityZone": "string",
      "configuration": { ... },
      "createdAt": "string",
      "id": "string",
      "ipAddress": "string",
      "maintenanceConfiguration": { ... },
      "maintenanceSchedule": { ... },
      "maintenanceScheduleType": "string",
      "maintenanceType": "string",
      "maximumBitrate": number,
      "messages": [ 
         { 
            "code": "string",
            "message": "string"
         }
      ],
      "name": "string",
      "outputType": "string",
      "regionName": "string",
      "routedInputArn": "string",
      "routedState": "string",
      "routingScope": "string",
      "state": "string",
      "streamDetails": { ... },
      "tags": { 
         "string" : "string" 
      },
      "tier": "string",
      "updatedAt": "string"
   }
}
```

## Response Elements
<a name="API_GetRouterOutput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [routerOutput](#API_GetRouterOutput_ResponseSyntax) **   <a name="mediaconnect-GetRouterOutput-response-routerOutput"></a>
The details of the requested router output, including its configuration, state, and other attributes.  
Type: [RouterOutput](API_RouterOutput.md) object

## Errors
<a name="API_GetRouterOutput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_GetRouterOutput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/GetRouterOutput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/GetRouterOutput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/GetRouterOutput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/GetRouterOutput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/GetRouterOutput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/GetRouterOutput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/GetRouterOutput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/GetRouterOutput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/GetRouterOutput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/GetRouterOutput) 

# GrantFlowEntitlements
<a name="API_GrantFlowEntitlements"></a>

 Grants entitlements to an existing flow.

## Request Syntax
<a name="API_GrantFlowEntitlements_RequestSyntax"></a>

```
POST /v1/flows/flowArn/entitlements HTTP/1.1
Content-type: application/json

{
   "entitlements": [ 
      { 
         "dataTransferSubscriberFeePercent": number,
         "description": "string",
         "encryption": { 
            "algorithm": "string",
            "constantInitializationVector": "string",
            "deviceId": "string",
            "keyType": "string",
            "region": "string",
            "resourceId": "string",
            "roleArn": "string",
            "secretArn": "string",
            "url": "string"
         },
         "entitlementStatus": "string",
         "entitlementTags": { 
            "string" : "string" 
         },
         "name": "string",
         "subscribers": [ "string" ]
      }
   ]
}
```

## URI Request Parameters
<a name="API_GrantFlowEntitlements_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_GrantFlowEntitlements_RequestSyntax) **   <a name="mediaconnect-GrantFlowEntitlements-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that you want to grant entitlements on.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

## Request Body
<a name="API_GrantFlowEntitlements_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [entitlements](#API_GrantFlowEntitlements_RequestSyntax) **   <a name="mediaconnect-GrantFlowEntitlements-request-entitlements"></a>
 The list of entitlements that you want to grant.  
Type: Array of [GrantEntitlementRequest](API_GrantEntitlementRequest.md) objects  
Required: Yes

## Response Syntax
<a name="API_GrantFlowEntitlements_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "entitlements": [ 
      { 
         "dataTransferSubscriberFeePercent": number,
         "description": "string",
         "encryption": { 
            "algorithm": "string",
            "constantInitializationVector": "string",
            "deviceId": "string",
            "keyType": "string",
            "region": "string",
            "resourceId": "string",
            "roleArn": "string",
            "secretArn": "string",
            "url": "string"
         },
         "entitlementArn": "string",
         "entitlementStatus": "string",
         "name": "string",
         "subscribers": [ "string" ]
      }
   ],
   "flowArn": "string"
}
```

## Response Elements
<a name="API_GrantFlowEntitlements_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [entitlements](#API_GrantFlowEntitlements_ResponseSyntax) **   <a name="mediaconnect-GrantFlowEntitlements-response-entitlements"></a>
 The entitlements that were just granted.  
Type: Array of [Entitlement](API_Entitlement.md) objects

 ** [flowArn](#API_GrantFlowEntitlements_ResponseSyntax) **   <a name="mediaconnect-GrantFlowEntitlements-response-flowArn"></a>
 The ARN of the flow that these entitlements were granted to.  
Type: String

## Errors
<a name="API_GrantFlowEntitlements_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** GrantFlowEntitlements420Exception **   
Exception raised by AWS Elemental MediaConnect when granting the entitlement. See the error message for the operation for more information on the cause of this exception.   
HTTP Status Code: 420

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_GrantFlowEntitlements_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/GrantFlowEntitlements) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/GrantFlowEntitlements) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/GrantFlowEntitlements) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/GrantFlowEntitlements) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/GrantFlowEntitlements) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/GrantFlowEntitlements) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/GrantFlowEntitlements) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/GrantFlowEntitlements) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/GrantFlowEntitlements) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/GrantFlowEntitlements) 

# ListBridges
<a name="API_ListBridges"></a>

 Displays a list of bridges that are associated with this account and an optionally specified Amazon Resource Name (ARN). This request returns a paginated result.

## Request Syntax
<a name="API_ListBridges_RequestSyntax"></a>

```
GET /v1/bridges?filterArn=filterArn&maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## URI Request Parameters
<a name="API_ListBridges_RequestParameters"></a>

The request uses the following URI parameters.

 ** [filterArn](#API_ListBridges_RequestSyntax) **   <a name="mediaconnect-ListBridges-request-uri-filterArn"></a>
 Filter the list results to display only the bridges associated with the selected ARN.

 ** [maxResults](#API_ListBridges_RequestSyntax) **   <a name="mediaconnect-ListBridges-request-uri-maxResults"></a>
 The maximum number of results to return per API request.   
For example, you submit a `ListBridges` request with `MaxResults` set at 5. Although 20 items match your request, the service returns no more than the first 5 items. (The service also returns a `NextToken` value that you can use to fetch the next batch of results.)   
The service might return fewer results than the `MaxResults` value. If `MaxResults` is not included in the request, the service defaults to pagination with a maximum of 10 results per page.  
Valid Range: Minimum value of 1. Maximum value of 1000.

 ** [nextToken](#API_ListBridges_RequestSyntax) **   <a name="mediaconnect-ListBridges-request-uri-nextToken"></a>
 The token that identifies the batch of results that you want to see.   
For example, you submit a `ListBridges` request with `MaxResults` set at 5. The service returns the first batch of results (up to 5) and a `NextToken` value. To see the next batch of results, you can submit the `ListBridges` request a second time and specify the `NextToken` value.

## Request Body
<a name="API_ListBridges_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListBridges_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "bridges": [ 
      { 
         "bridgeArn": "string",
         "bridgeState": "string",
         "bridgeType": "string",
         "name": "string",
         "placementArn": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListBridges_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [bridges](#API_ListBridges_ResponseSyntax) **   <a name="mediaconnect-ListBridges-response-bridges"></a>
 A list of bridge summaries.  
Type: Array of [ListedBridge](API_ListedBridge.md) objects

 ** [nextToken](#API_ListBridges_ResponseSyntax) **   <a name="mediaconnect-ListBridges-response-nextToken"></a>
 The token that identifies the batch of results that you want to see.   
For example, you submit a `ListBridges` request with `MaxResults` set at 5. The service returns the first batch of results (up to 5) and a `NextToken` value. To see the next batch of results, you can submit the `ListBridges` request a second time and specify the `NextToken` value.  
Type: String

## Errors
<a name="API_ListBridges_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_ListBridges_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/ListBridges) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/ListBridges) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/ListBridges) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/ListBridges) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/ListBridges) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/ListBridges) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/ListBridges) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/ListBridges) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/ListBridges) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/ListBridges) 

# ListEntitlements
<a name="API_ListEntitlements"></a>

 Displays a list of all entitlements that have been granted to this account. This request returns 20 results per page.

## Request Syntax
<a name="API_ListEntitlements_RequestSyntax"></a>

```
GET /v1/entitlements?maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## URI Request Parameters
<a name="API_ListEntitlements_RequestParameters"></a>

The request uses the following URI parameters.

 ** [maxResults](#API_ListEntitlements_RequestSyntax) **   <a name="mediaconnect-ListEntitlements-request-uri-maxResults"></a>
 The maximum number of results to return per API request.   
For example, you submit a `ListEntitlements` request with set at 5. Although 20 items match your request, the service returns no more than the first 5 items. (The service also returns a NextToken value that you can use to fetch the next batch of results.)   
The service might return fewer results than the `MaxResults` value. If `MaxResults` is not included in the request, the service defaults to pagination with a maximum of 20 results per page.  
Valid Range: Minimum value of 1. Maximum value of 1000.

 ** [nextToken](#API_ListEntitlements_RequestSyntax) **   <a name="mediaconnect-ListEntitlements-request-uri-nextToken"></a>
 The token that identifies the batch of results that you want to see.   
For example, you submit a `ListEntitlements` request with `MaxResults` set at 5. The service returns the first batch of results (up to 5) and a `NextToken` value. To see the next batch of results, you can submit the `ListEntitlements` request a second time and specify the `NextToken` value.

## Request Body
<a name="API_ListEntitlements_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListEntitlements_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "entitlements": [ 
      { 
         "dataTransferSubscriberFeePercent": number,
         "entitlementArn": "string",
         "entitlementName": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListEntitlements_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [entitlements](#API_ListEntitlements_ResponseSyntax) **   <a name="mediaconnect-ListEntitlements-response-entitlements"></a>
A list of entitlements that have been granted to you from other AWS accounts.   
Type: Array of [ListedEntitlement](API_ListedEntitlement.md) objects

 ** [nextToken](#API_ListEntitlements_ResponseSyntax) **   <a name="mediaconnect-ListEntitlements-response-nextToken"></a>
The token that identifies the batch of results that you want to see.   
For example, you submit a ListEntitlements request with `MaxResults` set at 5. The service returns the first batch of results (up to 5) and a NextToken value. To see the next batch of results, you can submit the `ListEntitlements` request a second time and specify the `NextToken` value.   
Type: String

## Errors
<a name="API_ListEntitlements_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_ListEntitlements_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/ListEntitlements) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/ListEntitlements) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/ListEntitlements) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/ListEntitlements) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/ListEntitlements) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/ListEntitlements) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/ListEntitlements) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/ListEntitlements) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/ListEntitlements) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/ListEntitlements) 

# ListFlows
<a name="API_ListFlows"></a>

 Displays a list of flows that are associated with this account. This request returns a paginated result.

## Request Syntax
<a name="API_ListFlows_RequestSyntax"></a>

```
GET /v1/flows?maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## URI Request Parameters
<a name="API_ListFlows_RequestParameters"></a>

The request uses the following URI parameters.

 ** [maxResults](#API_ListFlows_RequestSyntax) **   <a name="mediaconnect-ListFlows-request-uri-maxResults"></a>
 The maximum number of results to return per API request.   
For example, you submit a `ListFlows` request with MaxResults set at 5. Although 20 items match your request, the service returns no more than the first 5 items. (The service also returns a `NextToken` value that you can use to fetch the next batch of results.)   
The service might return fewer results than the `MaxResults` value. If `MaxResults` is not included in the request, the service defaults to pagination with a maximum of 10 results per page.  
Valid Range: Minimum value of 1. Maximum value of 1000.

 ** [nextToken](#API_ListFlows_RequestSyntax) **   <a name="mediaconnect-ListFlows-request-uri-nextToken"></a>
 The token that identifies the batch of results that you want to see.   
For example, you submit a `ListFlows` request with MaxResults set at 5. The service returns the first batch of results (up to 5) and a `NextToken` value. To see the next batch of results, you can submit the `ListFlows` request a second time and specify the `NextToken` value.

## Request Body
<a name="API_ListFlows_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListFlows_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "flows": [ 
      { 
         "availabilityZone": "string",
         "description": "string",
         "flowArn": "string",
         "maintenance": { 
            "maintenanceDay": "string",
            "maintenanceDeadline": "string",
            "maintenanceScheduledDate": "string",
            "maintenanceStartHour": "string"
         },
         "name": "string",
         "sourceType": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListFlows_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [flows](#API_ListFlows_ResponseSyntax) **   <a name="mediaconnect-ListFlows-response-flows"></a>
 A list of flow summaries.  
Type: Array of [ListedFlow](API_ListedFlow.md) objects

 ** [nextToken](#API_ListFlows_ResponseSyntax) **   <a name="mediaconnect-ListFlows-response-nextToken"></a>
 The token that identifies the batch of results that you want to see.   
For example, you submit a `ListFlows` request with MaxResults set at 5. The service returns the first batch of results (up to 5) and a `NextToken` value. To see the next batch of results, you can submit the `ListFlows` request a second time and specify the `NextToken` value.  
Type: String

## Errors
<a name="API_ListFlows_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_ListFlows_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/ListFlows) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/ListFlows) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/ListFlows) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/ListFlows) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/ListFlows) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/ListFlows) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/ListFlows) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/ListFlows) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/ListFlows) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/ListFlows) 

# ListGatewayInstances
<a name="API_ListGatewayInstances"></a>

 Displays a list of instances associated with the AWS account. This request returns a paginated result. You can use the filterArn property to display only the instances associated with the selected Gateway Amazon Resource Name (ARN).

## Request Syntax
<a name="API_ListGatewayInstances_RequestSyntax"></a>

```
GET /v1/gateway-instances?filterArn=filterArn&maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## URI Request Parameters
<a name="API_ListGatewayInstances_RequestParameters"></a>

The request uses the following URI parameters.

 ** [filterArn](#API_ListGatewayInstances_RequestSyntax) **   <a name="mediaconnect-ListGatewayInstances-request-uri-filterArn"></a>
 Filter the list results to display only the instances associated with the selected Gateway ARN.

 ** [maxResults](#API_ListGatewayInstances_RequestSyntax) **   <a name="mediaconnect-ListGatewayInstances-request-uri-maxResults"></a>
 The maximum number of results to return per API request.   
For example, you submit a ListInstances request with `MaxResults` set at 5. Although 20 items match your request, the service returns no more than the first 5 items. (The service also returns a `NextToken` value that you can use to fetch the next batch of results.)   
The service might return fewer results than the `MaxResults` value. If `MaxResults` is not included in the request, the service defaults to pagination with a maximum of 10 results per page.  
Valid Range: Minimum value of 1. Maximum value of 1000.

 ** [nextToken](#API_ListGatewayInstances_RequestSyntax) **   <a name="mediaconnect-ListGatewayInstances-request-uri-nextToken"></a>
 The token that identifies the batch of results that you want to see.   
For example, you submit a `ListInstances` request with `MaxResults` set at 5. The service returns the first batch of results (up to 5) and a `NextToken` value. To see the next batch of results, you can submit the `ListInstances` request a second time and specify the `NextToken` value.

## Request Body
<a name="API_ListGatewayInstances_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListGatewayInstances_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "instances": [ 
      { 
         "gatewayArn": "string",
         "gatewayInstanceArn": "string",
         "instanceId": "string",
         "instanceState": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListGatewayInstances_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [instances](#API_ListGatewayInstances_ResponseSyntax) **   <a name="mediaconnect-ListGatewayInstances-response-instances"></a>
 A list of instance summaries.  
Type: Array of [ListedGatewayInstance](API_ListedGatewayInstance.md) objects

 ** [nextToken](#API_ListGatewayInstances_ResponseSyntax) **   <a name="mediaconnect-ListGatewayInstances-response-nextToken"></a>
 The token that identifies the batch of results that you want to see.   
For example, you submit a `ListInstances` request with MaxResults set at 5. The service returns the first batch of results (up to 5) and a `NextToken` value. To see the next batch of results, you can submit the `ListInstances` request a second time and specify the `NextToken` value.  
Type: String

## Errors
<a name="API_ListGatewayInstances_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_ListGatewayInstances_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/ListGatewayInstances) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/ListGatewayInstances) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/ListGatewayInstances) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/ListGatewayInstances) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/ListGatewayInstances) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/ListGatewayInstances) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/ListGatewayInstances) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/ListGatewayInstances) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/ListGatewayInstances) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/ListGatewayInstances) 

# ListGateways
<a name="API_ListGateways"></a>

 Displays a list of gateways that are associated with this account. This request returns a paginated result.

## Request Syntax
<a name="API_ListGateways_RequestSyntax"></a>

```
GET /v1/gateways?maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## URI Request Parameters
<a name="API_ListGateways_RequestParameters"></a>

The request uses the following URI parameters.

 ** [maxResults](#API_ListGateways_RequestSyntax) **   <a name="mediaconnect-ListGateways-request-uri-maxResults"></a>
 The maximum number of results to return per API request.   
For example, you submit a `ListGateways` request with `MaxResults` set at 5. Although 20 items match your request, the service returns no more than the first 5 items. (The service also returns a `NextToken` value that you can use to fetch the next batch of results.)   
The service might return fewer results than the `MaxResults` value. If `MaxResults` is not included in the request, the service defaults to pagination with a maximum of 10 results per page.  
Valid Range: Minimum value of 1. Maximum value of 1000.

 ** [nextToken](#API_ListGateways_RequestSyntax) **   <a name="mediaconnect-ListGateways-request-uri-nextToken"></a>
 The token that identifies the batch of results that you want to see.   
For example, you submit a `ListGateways` request with `MaxResults` set at 5. The service returns the first batch of results (up to 5) and a `NextToken` value. To see the next batch of results, you can submit the `ListGateways` request a second time and specify the `NextToken` value.

## Request Body
<a name="API_ListGateways_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListGateways_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "gateways": [ 
      { 
         "gatewayArn": "string",
         "gatewayState": "string",
         "name": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListGateways_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [gateways](#API_ListGateways_ResponseSyntax) **   <a name="mediaconnect-ListGateways-response-gateways"></a>
 A list of gateway summaries.  
Type: Array of [ListedGateway](API_ListedGateway.md) objects

 ** [nextToken](#API_ListGateways_ResponseSyntax) **   <a name="mediaconnect-ListGateways-response-nextToken"></a>
 The token that identifies the batch of results that you want to see.   
For example, you submit a `ListGateways` request with `MaxResults` set at 5. The service returns the first batch of results (up to 5) and a `NextToken` value. To see the next batch of results, you can submit the `ListGateways` request a second time and specify the `NextToken` value.  
Type: String

## Errors
<a name="API_ListGateways_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_ListGateways_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/ListGateways) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/ListGateways) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/ListGateways) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/ListGateways) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/ListGateways) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/ListGateways) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/ListGateways) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/ListGateways) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/ListGateways) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/ListGateways) 

# ListOfferings
<a name="API_ListOfferings"></a>

 Displays a list of all offerings that are available to this account in the current AWS Region. If you have an active reservation (which means you've purchased an offering that has already started and hasn't expired yet), your account isn't eligible for other offerings.

## Request Syntax
<a name="API_ListOfferings_RequestSyntax"></a>

```
GET /v1/offerings?maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## URI Request Parameters
<a name="API_ListOfferings_RequestParameters"></a>

The request uses the following URI parameters.

 ** [maxResults](#API_ListOfferings_RequestSyntax) **   <a name="mediaconnect-ListOfferings-request-uri-maxResults"></a>
 The maximum number of results to return per API request.   
For example, you submit a `ListOfferings` request with `MaxResults` set at 5. Although 20 items match your request, the service returns no more than the first 5 items. (The service also returns a `NextToken` value that you can use to fetch the next batch of results.)   
The service might return fewer results than the `MaxResults` value. If `MaxResults` is not included in the request, the service defaults to pagination with a maximum of 10 results per page.  
Valid Range: Minimum value of 1. Maximum value of 1000.

 ** [nextToken](#API_ListOfferings_RequestSyntax) **   <a name="mediaconnect-ListOfferings-request-uri-nextToken"></a>
 The token that identifies the batch of results that you want to see.   
For example, you submit a `ListOfferings` request with `MaxResults` set at 5. The service returns the first batch of results (up to 5) and a `NextToken` value. To see the next batch of results, you can submit the `ListOfferings` request a second time and specify the `NextToken` value.

## Request Body
<a name="API_ListOfferings_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListOfferings_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "offerings": [ 
      { 
         "currencyCode": "string",
         "duration": number,
         "durationUnits": "string",
         "offeringArn": "string",
         "offeringDescription": "string",
         "pricePerUnit": "string",
         "priceUnits": "string",
         "resourceSpecification": { 
            "reservedBitrate": number,
            "resourceType": "string"
         }
      }
   ]
}
```

## Response Elements
<a name="API_ListOfferings_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListOfferings_ResponseSyntax) **   <a name="mediaconnect-ListOfferings-response-nextToken"></a>
 The token that identifies the batch of results that you want to see.   
For example, you submit a `ListOfferings` request with `MaxResults` set at 5. The service returns the first batch of results (up to 5) and a `NextToken` value. To see the next batch of results, you can submit the `ListOfferings` request a second time and specify the `NextToken` value.  
Type: String

 ** [offerings](#API_ListOfferings_ResponseSyntax) **   <a name="mediaconnect-ListOfferings-response-offerings"></a>
 A list of offerings that are available to this account in the current AWS Region.  
Type: Array of [Offering](API_Offering.md) objects

## Errors
<a name="API_ListOfferings_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_ListOfferings_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/ListOfferings) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/ListOfferings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/ListOfferings) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/ListOfferings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/ListOfferings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/ListOfferings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/ListOfferings) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/ListOfferings) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/ListOfferings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/ListOfferings) 

# ListReservations
<a name="API_ListReservations"></a>

 Displays a list of all reservations that have been purchased by this account in the current AWS Region. This list includes all reservations in all states (such as active and expired).

## Request Syntax
<a name="API_ListReservations_RequestSyntax"></a>

```
GET /v1/reservations?maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## URI Request Parameters
<a name="API_ListReservations_RequestParameters"></a>

The request uses the following URI parameters.

 ** [maxResults](#API_ListReservations_RequestSyntax) **   <a name="mediaconnect-ListReservations-request-uri-maxResults"></a>
 The maximum number of results to return per API request.   
For example, you submit a `ListReservations` request with `MaxResults` set at 5. Although 20 items match your request, the service returns no more than the first 5 items. (The service also returns a NextToken value that you can use to fetch the next batch of results.)   
The service might return fewer results than the `MaxResults` value. If `MaxResults` is not included in the request, the service defaults to pagination with a maximum of 10 results per page.  
Valid Range: Minimum value of 1. Maximum value of 1000.

 ** [nextToken](#API_ListReservations_RequestSyntax) **   <a name="mediaconnect-ListReservations-request-uri-nextToken"></a>
 The token that identifies the batch of results that you want to see.   
For example, you submit a `ListReservations` request with `MaxResults` set at 5. The service returns the first batch of results (up to 5) and a `NextToken` value. To see the next batch of results, you can submit the `ListOfferings` request a second time and specify the `NextToken` value. 

## Request Body
<a name="API_ListReservations_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListReservations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "reservations": [ 
      { 
         "currencyCode": "string",
         "duration": number,
         "durationUnits": "string",
         "end": "string",
         "offeringArn": "string",
         "offeringDescription": "string",
         "pricePerUnit": "string",
         "priceUnits": "string",
         "reservationArn": "string",
         "reservationName": "string",
         "reservationState": "string",
         "resourceSpecification": { 
            "reservedBitrate": number,
            "resourceType": "string"
         },
         "start": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListReservations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListReservations_ResponseSyntax) **   <a name="mediaconnect-ListReservations-response-nextToken"></a>
 The token that identifies the batch of results that you want to see.   
For example, you submit a `ListReservations` request with `MaxResults` set at 5. The service returns the first batch of results (up to 5) and a `NextToken` value. To see the next batch of results, you can submit the `ListReservations` request a second time and specify the `NextToken` value.  
Type: String

 ** [reservations](#API_ListReservations_ResponseSyntax) **   <a name="mediaconnect-ListReservations-response-reservations"></a>
 A list of all reservations that have been purchased by this account in the current AWS Region.   
Type: Array of [Reservation](API_Reservation.md) objects

## Errors
<a name="API_ListReservations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_ListReservations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/ListReservations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/ListReservations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/ListReservations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/ListReservations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/ListReservations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/ListReservations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/ListReservations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/ListReservations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/ListReservations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/ListReservations) 

# ListRouterInputs
<a name="API_ListRouterInputs"></a>

Retrieves a list of router inputs in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_ListRouterInputs_RequestSyntax"></a>

```
POST /v1/routerInputs?maxResults=maxResults&nextToken=nextToken HTTP/1.1
Content-type: application/json

{
   "filters": [ 
      { ... }
   ]
}
```

## URI Request Parameters
<a name="API_ListRouterInputs_RequestParameters"></a>

The request uses the following URI parameters.

 ** [maxResults](#API_ListRouterInputs_RequestSyntax) **   <a name="mediaconnect-ListRouterInputs-request-uri-maxResults"></a>
The maximum number of router inputs to return in the response.  
Valid Range: Minimum value of 1. Maximum value of 100.

 ** [nextToken](#API_ListRouterInputs_RequestSyntax) **   <a name="mediaconnect-ListRouterInputs-request-uri-nextToken"></a>
A token used to retrieve the next page of results.

## Request Body
<a name="API_ListRouterInputs_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [filters](#API_ListRouterInputs_RequestSyntax) **   <a name="mediaconnect-ListRouterInputs-request-filters"></a>
The filters to apply when retrieving the list of router inputs.  
Type: Array of [RouterInputFilter](API_RouterInputFilter.md) objects  
Required: No

## Response Syntax
<a name="API_ListRouterInputs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "routerInputs": [ 
      { 
         "arn": "string",
         "availabilityZone": "string",
         "createdAt": "string",
         "id": "string",
         "inputType": "string",
         "maintenanceSchedule": { ... },
         "maintenanceScheduleType": "string",
         "maximumBitrate": number,
         "messageCount": number,
         "name": "string",
         "networkInterfaceArn": "string",
         "regionName": "string",
         "routedOutputs": number,
         "routingScope": "string",
         "state": "string",
         "updatedAt": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListRouterInputs_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListRouterInputs_ResponseSyntax) **   <a name="mediaconnect-ListRouterInputs-response-nextToken"></a>
The token to use to retrieve the next page of results.  
Type: String

 ** [routerInputs](#API_ListRouterInputs_ResponseSyntax) **   <a name="mediaconnect-ListRouterInputs-response-routerInputs"></a>
The summary information for the retrieved router inputs.  
Type: Array of [ListedRouterInput](API_ListedRouterInput.md) objects

## Errors
<a name="API_ListRouterInputs_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_ListRouterInputs_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/ListRouterInputs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/ListRouterInputs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/ListRouterInputs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/ListRouterInputs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/ListRouterInputs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/ListRouterInputs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/ListRouterInputs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/ListRouterInputs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/ListRouterInputs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/ListRouterInputs) 

# ListRouterNetworkInterfaces
<a name="API_ListRouterNetworkInterfaces"></a>

Retrieves a list of router network interfaces in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_ListRouterNetworkInterfaces_RequestSyntax"></a>

```
POST /v1/routerNetworkInterfaces?maxResults=maxResults&nextToken=nextToken HTTP/1.1
Content-type: application/json

{
   "filters": [ 
      { ... }
   ]
}
```

## URI Request Parameters
<a name="API_ListRouterNetworkInterfaces_RequestParameters"></a>

The request uses the following URI parameters.

 ** [maxResults](#API_ListRouterNetworkInterfaces_RequestSyntax) **   <a name="mediaconnect-ListRouterNetworkInterfaces-request-uri-maxResults"></a>
The maximum number of router network interfaces to return in the response.  
Valid Range: Minimum value of 1. Maximum value of 100.

 ** [nextToken](#API_ListRouterNetworkInterfaces_RequestSyntax) **   <a name="mediaconnect-ListRouterNetworkInterfaces-request-uri-nextToken"></a>
A token used to retrieve the next page of results.

## Request Body
<a name="API_ListRouterNetworkInterfaces_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [filters](#API_ListRouterNetworkInterfaces_RequestSyntax) **   <a name="mediaconnect-ListRouterNetworkInterfaces-request-filters"></a>
The filters to apply when retrieving the list of router network interfaces.  
Type: Array of [RouterNetworkInterfaceFilter](API_RouterNetworkInterfaceFilter.md) objects  
Required: No

## Response Syntax
<a name="API_ListRouterNetworkInterfaces_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "routerNetworkInterfaces": [ 
      { 
         "arn": "string",
         "associatedInputCount": number,
         "associatedOutputCount": number,
         "createdAt": "string",
         "id": "string",
         "name": "string",
         "networkInterfaceType": "string",
         "regionName": "string",
         "state": "string",
         "updatedAt": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListRouterNetworkInterfaces_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListRouterNetworkInterfaces_ResponseSyntax) **   <a name="mediaconnect-ListRouterNetworkInterfaces-response-nextToken"></a>
The token to use to retrieve the next page of results.  
Type: String

 ** [routerNetworkInterfaces](#API_ListRouterNetworkInterfaces_ResponseSyntax) **   <a name="mediaconnect-ListRouterNetworkInterfaces-response-routerNetworkInterfaces"></a>
The summary information for the retrieved router network interfaces.  
Type: Array of [ListedRouterNetworkInterface](API_ListedRouterNetworkInterface.md) objects

## Errors
<a name="API_ListRouterNetworkInterfaces_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_ListRouterNetworkInterfaces_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/ListRouterNetworkInterfaces) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/ListRouterNetworkInterfaces) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/ListRouterNetworkInterfaces) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/ListRouterNetworkInterfaces) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/ListRouterNetworkInterfaces) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/ListRouterNetworkInterfaces) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/ListRouterNetworkInterfaces) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/ListRouterNetworkInterfaces) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/ListRouterNetworkInterfaces) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/ListRouterNetworkInterfaces) 

# ListRouterOutputs
<a name="API_ListRouterOutputs"></a>

Retrieves a list of router outputs in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_ListRouterOutputs_RequestSyntax"></a>

```
POST /v1/routerOutputs?maxResults=maxResults&nextToken=nextToken HTTP/1.1
Content-type: application/json

{
   "filters": [ 
      { ... }
   ]
}
```

## URI Request Parameters
<a name="API_ListRouterOutputs_RequestParameters"></a>

The request uses the following URI parameters.

 ** [maxResults](#API_ListRouterOutputs_RequestSyntax) **   <a name="mediaconnect-ListRouterOutputs-request-uri-maxResults"></a>
The maximum number of router outputs to return in the response.  
Valid Range: Minimum value of 1. Maximum value of 100.

 ** [nextToken](#API_ListRouterOutputs_RequestSyntax) **   <a name="mediaconnect-ListRouterOutputs-request-uri-nextToken"></a>
A token used to retrieve the next page of results.

## Request Body
<a name="API_ListRouterOutputs_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [filters](#API_ListRouterOutputs_RequestSyntax) **   <a name="mediaconnect-ListRouterOutputs-request-filters"></a>
The filters to apply when retrieving the list of router outputs.  
Type: Array of [RouterOutputFilter](API_RouterOutputFilter.md) objects  
Required: No

## Response Syntax
<a name="API_ListRouterOutputs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "routerOutputs": [ 
      { 
         "arn": "string",
         "availabilityZone": "string",
         "createdAt": "string",
         "id": "string",
         "maintenanceSchedule": { ... },
         "maintenanceScheduleType": "string",
         "maximumBitrate": number,
         "messageCount": number,
         "name": "string",
         "networkInterfaceArn": "string",
         "outputType": "string",
         "regionName": "string",
         "routedInputArn": "string",
         "routedState": "string",
         "routingScope": "string",
         "state": "string",
         "updatedAt": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListRouterOutputs_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListRouterOutputs_ResponseSyntax) **   <a name="mediaconnect-ListRouterOutputs-response-nextToken"></a>
The token to use to retrieve the next page of results.  
Type: String

 ** [routerOutputs](#API_ListRouterOutputs_ResponseSyntax) **   <a name="mediaconnect-ListRouterOutputs-response-routerOutputs"></a>
The summary information for the retrieved router outputs.  
Type: Array of [ListedRouterOutput](API_ListedRouterOutput.md) objects

## Errors
<a name="API_ListRouterOutputs_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_ListRouterOutputs_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/ListRouterOutputs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/ListRouterOutputs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/ListRouterOutputs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/ListRouterOutputs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/ListRouterOutputs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/ListRouterOutputs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/ListRouterOutputs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/ListRouterOutputs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/ListRouterOutputs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/ListRouterOutputs) 

# ListTagsForGlobalResource
<a name="API_ListTagsForGlobalResource"></a>

Lists the tags associated with a global resource in AWS Elemental MediaConnect. The API supports the following global resources: router inputs, router outputs and router network interfaces. 

## Request Syntax
<a name="API_ListTagsForGlobalResource_RequestSyntax"></a>

```
GET /tags/global/resourceArn HTTP/1.1
```

## URI Request Parameters
<a name="API_ListTagsForGlobalResource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [resourceArn](#API_ListTagsForGlobalResource_RequestSyntax) **   <a name="mediaconnect-ListTagsForGlobalResource-request-uri-resourceArn"></a>
The Amazon Resource Name (ARN) of the global resource whose tags you want to list.  
Required: Yes

## Request Body
<a name="API_ListTagsForGlobalResource_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListTagsForGlobalResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "tags": { 
      "string" : "string" 
   }
}
```

## Response Elements
<a name="API_ListTagsForGlobalResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [tags](#API_ListTagsForGlobalResource_ResponseSyntax) **   <a name="mediaconnect-ListTagsForGlobalResource-response-tags"></a>
A map of tag keys and values associated with the global resource.  
Type: String to string map

## Errors
<a name="API_ListTagsForGlobalResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

## See Also
<a name="API_ListTagsForGlobalResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/ListTagsForGlobalResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/ListTagsForGlobalResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/ListTagsForGlobalResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/ListTagsForGlobalResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/ListTagsForGlobalResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/ListTagsForGlobalResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/ListTagsForGlobalResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/ListTagsForGlobalResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/ListTagsForGlobalResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/ListTagsForGlobalResource) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

 List all tags on a MediaConnect resource in the current region.

## Request Syntax
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
GET /tags/resourceArn HTTP/1.1
```

## URI Request Parameters
<a name="API_ListTagsForResource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="mediaconnect-ListTagsForResource-request-uri-resourceArn"></a>
 The Amazon Resource Name (ARN) that identifies the MediaConnect resource for which to list the tags.  
Required: Yes

## Request Body
<a name="API_ListTagsForResource_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListTagsForResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "tags": { 
      "string" : "string" 
   }
}
```

## Response Elements
<a name="API_ListTagsForResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="mediaconnect-ListTagsForResource-response-tags"></a>
 A map from tag keys to values. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.  
Type: String to string map

## Errors
<a name="API_ListTagsForResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

## See Also
<a name="API_ListTagsForResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/ListTagsForResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/ListTagsForResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/ListTagsForResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/ListTagsForResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/ListTagsForResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/ListTagsForResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/ListTagsForResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/ListTagsForResource) 

# PurchaseOffering
<a name="API_PurchaseOffering"></a>

 Submits a request to purchase an offering. If you already have an active reservation, you can't purchase another offering.

## Request Syntax
<a name="API_PurchaseOffering_RequestSyntax"></a>

```
POST /v1/offerings/offeringArn HTTP/1.1
Content-type: application/json

{
   "reservationName": "string",
   "start": "string"
}
```

## URI Request Parameters
<a name="API_PurchaseOffering_RequestParameters"></a>

The request uses the following URI parameters.

 ** [offeringArn](#API_PurchaseOffering_RequestSyntax) **   <a name="mediaconnect-PurchaseOffering-request-uri-offeringArn"></a>
 The Amazon Resource Name (ARN) of the offering.  
Required: Yes

## Request Body
<a name="API_PurchaseOffering_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [reservationName](#API_PurchaseOffering_RequestSyntax) **   <a name="mediaconnect-PurchaseOffering-request-reservationName"></a>
 The name that you want to use for the reservation.  
Type: String  
Required: Yes

 ** [start](#API_PurchaseOffering_RequestSyntax) **   <a name="mediaconnect-PurchaseOffering-request-start"></a>
 The date and time that you want the reservation to begin, in Coordinated Universal Time (UTC).   
You can specify any date and time between 12:00am on the first day of the current month to the current time on today's date, inclusive. Specify the start in a 24-hour notation. Use the following format: `YYYY-MM-DDTHH:mm:SSZ`, where `T` and `Z` are literal characters. For example, to specify 11:30pm on March 5, 2020, enter `2020-03-05T23:30:00Z`.  
Type: String  
Required: Yes

## Response Syntax
<a name="API_PurchaseOffering_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "reservation": { 
      "currencyCode": "string",
      "duration": number,
      "durationUnits": "string",
      "end": "string",
      "offeringArn": "string",
      "offeringDescription": "string",
      "pricePerUnit": "string",
      "priceUnits": "string",
      "reservationArn": "string",
      "reservationName": "string",
      "reservationState": "string",
      "resourceSpecification": { 
         "reservedBitrate": number,
         "resourceType": "string"
      },
      "start": "string"
   }
}
```

## Response Elements
<a name="API_PurchaseOffering_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 201 response.

The following data is returned in JSON format by the service.

 ** [reservation](#API_PurchaseOffering_ResponseSyntax) **   <a name="mediaconnect-PurchaseOffering-response-reservation"></a>
The details of the reservation that you just created when you purchased the offering.   
Type: [Reservation](API_Reservation.md) object

## Errors
<a name="API_PurchaseOffering_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_PurchaseOffering_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/PurchaseOffering) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/PurchaseOffering) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/PurchaseOffering) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/PurchaseOffering) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/PurchaseOffering) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/PurchaseOffering) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/PurchaseOffering) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/PurchaseOffering) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/PurchaseOffering) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/PurchaseOffering) 

# RemoveBridgeOutput
<a name="API_RemoveBridgeOutput"></a>

 Removes an output from a bridge.

## Request Syntax
<a name="API_RemoveBridgeOutput_RequestSyntax"></a>

```
DELETE /v1/bridges/bridgeArn/outputs/outputName HTTP/1.1
```

## URI Request Parameters
<a name="API_RemoveBridgeOutput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [bridgeArn](#API_RemoveBridgeOutput_RequestSyntax) **   <a name="mediaconnect-RemoveBridgeOutput-request-uri-bridgeArn"></a>
 The Amazon Resource Name (ARN) of the bridge that you want to update.  
Pattern: `arn:.+:mediaconnect.+:bridge:.+`   
Required: Yes

 ** [outputName](#API_RemoveBridgeOutput_RequestSyntax) **   <a name="mediaconnect-RemoveBridgeOutput-request-uri-outputName"></a>
 The name of the bridge output that you want to remove.  
Required: Yes

## Request Body
<a name="API_RemoveBridgeOutput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_RemoveBridgeOutput_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "bridgeArn": "string",
   "outputName": "string"
}
```

## Response Elements
<a name="API_RemoveBridgeOutput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [bridgeArn](#API_RemoveBridgeOutput_ResponseSyntax) **   <a name="mediaconnect-RemoveBridgeOutput-response-bridgeArn"></a>
 The ARN of the bridge from which the output was removed.   
Type: String

 ** [outputName](#API_RemoveBridgeOutput_ResponseSyntax) **   <a name="mediaconnect-RemoveBridgeOutput-response-outputName"></a>
 The name of the bridge output that was removed.   
Type: String

## Errors
<a name="API_RemoveBridgeOutput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_RemoveBridgeOutput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/RemoveBridgeOutput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/RemoveBridgeOutput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/RemoveBridgeOutput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/RemoveBridgeOutput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/RemoveBridgeOutput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/RemoveBridgeOutput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/RemoveBridgeOutput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/RemoveBridgeOutput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/RemoveBridgeOutput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/RemoveBridgeOutput) 

# RemoveBridgeSource
<a name="API_RemoveBridgeSource"></a>

 Removes a source from a bridge.

## Request Syntax
<a name="API_RemoveBridgeSource_RequestSyntax"></a>

```
DELETE /v1/bridges/bridgeArn/sources/sourceName HTTP/1.1
```

## URI Request Parameters
<a name="API_RemoveBridgeSource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [bridgeArn](#API_RemoveBridgeSource_RequestSyntax) **   <a name="mediaconnect-RemoveBridgeSource-request-uri-bridgeArn"></a>
 The Amazon Resource Name (ARN) of the bridge that you want to update.  
Pattern: `arn:.+:mediaconnect.+:bridge:.+`   
Required: Yes

 ** [sourceName](#API_RemoveBridgeSource_RequestSyntax) **   <a name="mediaconnect-RemoveBridgeSource-request-uri-sourceName"></a>
 The name of the bridge source that you want to remove.  
Required: Yes

## Request Body
<a name="API_RemoveBridgeSource_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_RemoveBridgeSource_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "bridgeArn": "string",
   "sourceName": "string"
}
```

## Response Elements
<a name="API_RemoveBridgeSource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [bridgeArn](#API_RemoveBridgeSource_ResponseSyntax) **   <a name="mediaconnect-RemoveBridgeSource-response-bridgeArn"></a>
 The ARN of the bridge from which the source was removed.   
Type: String

 ** [sourceName](#API_RemoveBridgeSource_ResponseSyntax) **   <a name="mediaconnect-RemoveBridgeSource-response-sourceName"></a>
 The name of the bridge source that was removed.   
Type: String

## Errors
<a name="API_RemoveBridgeSource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_RemoveBridgeSource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/RemoveBridgeSource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/RemoveBridgeSource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/RemoveBridgeSource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/RemoveBridgeSource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/RemoveBridgeSource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/RemoveBridgeSource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/RemoveBridgeSource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/RemoveBridgeSource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/RemoveBridgeSource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/RemoveBridgeSource) 

# RemoveFlowMediaStream
<a name="API_RemoveFlowMediaStream"></a>

 Removes a media stream from a flow. This action is only available if the media stream is not associated with a source or output.

## Request Syntax
<a name="API_RemoveFlowMediaStream_RequestSyntax"></a>

```
DELETE /v1/flows/flowArn/mediaStreams/mediaStreamName HTTP/1.1
```

## URI Request Parameters
<a name="API_RemoveFlowMediaStream_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_RemoveFlowMediaStream_RequestSyntax) **   <a name="mediaconnect-RemoveFlowMediaStream-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that you want to update.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

 ** [mediaStreamName](#API_RemoveFlowMediaStream_RequestSyntax) **   <a name="mediaconnect-RemoveFlowMediaStream-request-uri-mediaStreamName"></a>
 The name of the media stream that you want to remove.  
Required: Yes

## Request Body
<a name="API_RemoveFlowMediaStream_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_RemoveFlowMediaStream_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "flowArn": "string",
   "mediaStreamName": "string"
}
```

## Response Elements
<a name="API_RemoveFlowMediaStream_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_RemoveFlowMediaStream_ResponseSyntax) **   <a name="mediaconnect-RemoveFlowMediaStream-response-flowArn"></a>
 The ARN of the flow that was updated.  
Type: String

 ** [mediaStreamName](#API_RemoveFlowMediaStream_ResponseSyntax) **   <a name="mediaconnect-RemoveFlowMediaStream-response-mediaStreamName"></a>
 The name of the media stream that was removed.  
Type: String

## Errors
<a name="API_RemoveFlowMediaStream_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_RemoveFlowMediaStream_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/RemoveFlowMediaStream) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/RemoveFlowMediaStream) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/RemoveFlowMediaStream) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/RemoveFlowMediaStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/RemoveFlowMediaStream) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/RemoveFlowMediaStream) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/RemoveFlowMediaStream) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/RemoveFlowMediaStream) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/RemoveFlowMediaStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/RemoveFlowMediaStream) 

# RemoveFlowOutput
<a name="API_RemoveFlowOutput"></a>

 Removes an output from an existing flow. This request can be made only on an output that does not have an entitlement associated with it. If the output has an entitlement, you must revoke the entitlement instead. When an entitlement is revoked from a flow, the service automatically removes the associated output.

## Request Syntax
<a name="API_RemoveFlowOutput_RequestSyntax"></a>

```
DELETE /v1/flows/flowArn/outputs/outputArn HTTP/1.1
```

## URI Request Parameters
<a name="API_RemoveFlowOutput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_RemoveFlowOutput_RequestSyntax) **   <a name="mediaconnect-RemoveFlowOutput-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that you want to remove an output from.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

 ** [outputArn](#API_RemoveFlowOutput_RequestSyntax) **   <a name="mediaconnect-RemoveFlowOutput-request-uri-outputArn"></a>
 The ARN of the output that you want to remove.   
Pattern: `arn:.+:mediaconnect.+:output:.+`   
Required: Yes

## Request Body
<a name="API_RemoveFlowOutput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_RemoveFlowOutput_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "flowArn": "string",
   "outputArn": "string"
}
```

## Response Elements
<a name="API_RemoveFlowOutput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_RemoveFlowOutput_ResponseSyntax) **   <a name="mediaconnect-RemoveFlowOutput-response-flowArn"></a>
 The ARN of the flow that the output was removed from.   
Type: String

 ** [outputArn](#API_RemoveFlowOutput_ResponseSyntax) **   <a name="mediaconnect-RemoveFlowOutput-response-outputArn"></a>
 The ARN of the output that was removed.   
Type: String

## Errors
<a name="API_RemoveFlowOutput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_RemoveFlowOutput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/RemoveFlowOutput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/RemoveFlowOutput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/RemoveFlowOutput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/RemoveFlowOutput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/RemoveFlowOutput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/RemoveFlowOutput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/RemoveFlowOutput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/RemoveFlowOutput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/RemoveFlowOutput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/RemoveFlowOutput) 

# RemoveFlowSource
<a name="API_RemoveFlowSource"></a>

 Removes a source from an existing flow. This request can be made only if there is more than one source on the flow. 

## Request Syntax
<a name="API_RemoveFlowSource_RequestSyntax"></a>

```
DELETE /v1/flows/flowArn/source/sourceArn HTTP/1.1
```

## URI Request Parameters
<a name="API_RemoveFlowSource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_RemoveFlowSource_RequestSyntax) **   <a name="mediaconnect-RemoveFlowSource-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that you want to remove a source from.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

 ** [sourceArn](#API_RemoveFlowSource_RequestSyntax) **   <a name="mediaconnect-RemoveFlowSource-request-uri-sourceArn"></a>
 The ARN of the source that you want to remove.  
Pattern: `arn:.+:mediaconnect.+:source:.+`   
Required: Yes

## Request Body
<a name="API_RemoveFlowSource_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_RemoveFlowSource_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "flowArn": "string",
   "sourceArn": "string"
}
```

## Response Elements
<a name="API_RemoveFlowSource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_RemoveFlowSource_ResponseSyntax) **   <a name="mediaconnect-RemoveFlowSource-response-flowArn"></a>
 The ARN of the flow that the source was removed from.   
Type: String

 ** [sourceArn](#API_RemoveFlowSource_ResponseSyntax) **   <a name="mediaconnect-RemoveFlowSource-response-sourceArn"></a>
 The ARN of the source that was removed.   
Type: String

## Errors
<a name="API_RemoveFlowSource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_RemoveFlowSource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/RemoveFlowSource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/RemoveFlowSource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/RemoveFlowSource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/RemoveFlowSource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/RemoveFlowSource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/RemoveFlowSource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/RemoveFlowSource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/RemoveFlowSource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/RemoveFlowSource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/RemoveFlowSource) 

# RemoveFlowVpcInterface
<a name="API_RemoveFlowVpcInterface"></a>

 Removes a VPC Interface from an existing flow. This request can be made only on a VPC interface that does not have a Source or Output associated with it. If the VPC interface is referenced by a Source or Output, you must first delete or update the Source or Output to no longer reference the VPC interface.

## Request Syntax
<a name="API_RemoveFlowVpcInterface_RequestSyntax"></a>

```
DELETE /v1/flows/flowArn/vpcInterfaces/vpcInterfaceName HTTP/1.1
```

## URI Request Parameters
<a name="API_RemoveFlowVpcInterface_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_RemoveFlowVpcInterface_RequestSyntax) **   <a name="mediaconnect-RemoveFlowVpcInterface-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that you want to remove a VPC interface from.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

 ** [vpcInterfaceName](#API_RemoveFlowVpcInterface_RequestSyntax) **   <a name="mediaconnect-RemoveFlowVpcInterface-request-uri-vpcInterfaceName"></a>
 The name of the VPC interface that you want to remove.  
Required: Yes

## Request Body
<a name="API_RemoveFlowVpcInterface_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_RemoveFlowVpcInterface_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "flowArn": "string",
   "nonDeletedNetworkInterfaceIds": [ "string" ],
   "vpcInterfaceName": "string"
}
```

## Response Elements
<a name="API_RemoveFlowVpcInterface_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_RemoveFlowVpcInterface_ResponseSyntax) **   <a name="mediaconnect-RemoveFlowVpcInterface-response-flowArn"></a>
 The ARN of the flow that is associated with the VPC interface you removed.  
Type: String

 ** [nonDeletedNetworkInterfaceIds](#API_RemoveFlowVpcInterface_ResponseSyntax) **   <a name="mediaconnect-RemoveFlowVpcInterface-response-nonDeletedNetworkInterfaceIds"></a>
 IDs of network interfaces associated with the removed VPC interface that MediaConnect was unable to remove.  
Type: Array of strings

 ** [vpcInterfaceName](#API_RemoveFlowVpcInterface_ResponseSyntax) **   <a name="mediaconnect-RemoveFlowVpcInterface-response-vpcInterfaceName"></a>
 The name of the VPC interface that was removed.  
Type: String

## Errors
<a name="API_RemoveFlowVpcInterface_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_RemoveFlowVpcInterface_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/RemoveFlowVpcInterface) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/RemoveFlowVpcInterface) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/RemoveFlowVpcInterface) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/RemoveFlowVpcInterface) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/RemoveFlowVpcInterface) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/RemoveFlowVpcInterface) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/RemoveFlowVpcInterface) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/RemoveFlowVpcInterface) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/RemoveFlowVpcInterface) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/RemoveFlowVpcInterface) 

# RestartRouterInput
<a name="API_RestartRouterInput"></a>

Restarts a router input. This operation can be used to recover from errors or refresh the input state.

## Request Syntax
<a name="API_RestartRouterInput_RequestSyntax"></a>

```
POST /v1/routerInput/restart/arn HTTP/1.1
```

## URI Request Parameters
<a name="API_RestartRouterInput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_RestartRouterInput_RequestSyntax) **   <a name="mediaconnect-RestartRouterInput-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router input that you want to restart.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_RestartRouterInput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_RestartRouterInput_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "arn": "string",
   "name": "string",
   "state": "string"
}
```

## Response Elements
<a name="API_RestartRouterInput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [arn](#API_RestartRouterInput_ResponseSyntax) **   <a name="mediaconnect-RestartRouterInput-response-arn"></a>
The ARN of the router input that was restarted.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}` 

 ** [name](#API_RestartRouterInput_ResponseSyntax) **   <a name="mediaconnect-RestartRouterInput-response-name"></a>
The name of the router input that was restarted.  
Type: String

 ** [state](#API_RestartRouterInput_ResponseSyntax) **   <a name="mediaconnect-RestartRouterInput-response-state"></a>
The current state of the router input after the restart operation.  
Type: String  
Valid Values: `CREATING | STANDBY | STARTING | ACTIVE | STOPPING | DELETING | UPDATING | ERROR | RECOVERING | MIGRATING` 

## Errors
<a name="API_RestartRouterInput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_RestartRouterInput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/RestartRouterInput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/RestartRouterInput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/RestartRouterInput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/RestartRouterInput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/RestartRouterInput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/RestartRouterInput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/RestartRouterInput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/RestartRouterInput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/RestartRouterInput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/RestartRouterInput) 

# RestartRouterOutput
<a name="API_RestartRouterOutput"></a>

Restarts a router output. This operation can be used to recover from errors or refresh the output state.

## Request Syntax
<a name="API_RestartRouterOutput_RequestSyntax"></a>

```
POST /v1/routerOutput/restart/arn HTTP/1.1
```

## URI Request Parameters
<a name="API_RestartRouterOutput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_RestartRouterOutput_RequestSyntax) **   <a name="mediaconnect-RestartRouterOutput-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router output that you want to restart.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerOutput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_RestartRouterOutput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_RestartRouterOutput_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "arn": "string",
   "name": "string",
   "state": "string"
}
```

## Response Elements
<a name="API_RestartRouterOutput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [arn](#API_RestartRouterOutput_ResponseSyntax) **   <a name="mediaconnect-RestartRouterOutput-response-arn"></a>
The ARN of the router output that was restarted.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerOutput:[a-z0-9]{12}` 

 ** [name](#API_RestartRouterOutput_ResponseSyntax) **   <a name="mediaconnect-RestartRouterOutput-response-name"></a>
The name of the router output that was restarted.  
Type: String

 ** [state](#API_RestartRouterOutput_ResponseSyntax) **   <a name="mediaconnect-RestartRouterOutput-response-state"></a>
The current state of the router output after the restart operation.  
Type: String  
Valid Values: `CREATING | STANDBY | STARTING | ACTIVE | STOPPING | DELETING | UPDATING | ERROR | RECOVERING | MIGRATING` 

## Errors
<a name="API_RestartRouterOutput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_RestartRouterOutput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/RestartRouterOutput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/RestartRouterOutput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/RestartRouterOutput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/RestartRouterOutput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/RestartRouterOutput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/RestartRouterOutput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/RestartRouterOutput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/RestartRouterOutput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/RestartRouterOutput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/RestartRouterOutput) 

# RevokeFlowEntitlement
<a name="API_RevokeFlowEntitlement"></a>

 Revokes an entitlement from a flow. Once an entitlement is revoked, the content becomes unavailable to the subscriber and the associated output is removed.

## Request Syntax
<a name="API_RevokeFlowEntitlement_RequestSyntax"></a>

```
DELETE /v1/flows/flowArn/entitlements/entitlementArn HTTP/1.1
```

## URI Request Parameters
<a name="API_RevokeFlowEntitlement_RequestParameters"></a>

The request uses the following URI parameters.

 ** [entitlementArn](#API_RevokeFlowEntitlement_RequestSyntax) **   <a name="mediaconnect-RevokeFlowEntitlement-request-uri-entitlementArn"></a>
 The Amazon Resource Name (ARN) of the entitlement that you want to revoke.  
Pattern: `arn:.+:mediaconnect.+:entitlement:.+`   
Required: Yes

 ** [flowArn](#API_RevokeFlowEntitlement_RequestSyntax) **   <a name="mediaconnect-RevokeFlowEntitlement-request-uri-flowArn"></a>
 The flow that you want to revoke an entitlement from.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

## Request Body
<a name="API_RevokeFlowEntitlement_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_RevokeFlowEntitlement_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "entitlementArn": "string",
   "flowArn": "string"
}
```

## Response Elements
<a name="API_RevokeFlowEntitlement_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [entitlementArn](#API_RevokeFlowEntitlement_ResponseSyntax) **   <a name="mediaconnect-RevokeFlowEntitlement-response-entitlementArn"></a>
 The ARN of the entitlement that was revoked.  
Type: String

 ** [flowArn](#API_RevokeFlowEntitlement_ResponseSyntax) **   <a name="mediaconnect-RevokeFlowEntitlement-response-flowArn"></a>
 The ARN of the flow that the entitlement was revoked from.  
Type: String

## Errors
<a name="API_RevokeFlowEntitlement_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_RevokeFlowEntitlement_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/RevokeFlowEntitlement) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/RevokeFlowEntitlement) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/RevokeFlowEntitlement) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/RevokeFlowEntitlement) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/RevokeFlowEntitlement) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/RevokeFlowEntitlement) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/RevokeFlowEntitlement) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/RevokeFlowEntitlement) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/RevokeFlowEntitlement) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/RevokeFlowEntitlement) 

# StartFlow
<a name="API_StartFlow"></a>

 Starts a flow.

## Request Syntax
<a name="API_StartFlow_RequestSyntax"></a>

```
POST /v1/flows/start/flowArn HTTP/1.1
```

## URI Request Parameters
<a name="API_StartFlow_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_StartFlow_RequestSyntax) **   <a name="mediaconnect-StartFlow-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that you want to start.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

## Request Body
<a name="API_StartFlow_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_StartFlow_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "flowArn": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_StartFlow_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_StartFlow_ResponseSyntax) **   <a name="mediaconnect-StartFlow-response-flowArn"></a>
 The ARN of the flow that you started.  
Type: String

 ** [status](#API_StartFlow_ResponseSyntax) **   <a name="mediaconnect-StartFlow-response-status"></a>
 The status of the flow when the `StartFlow` process begins.  
Type: String  
Valid Values: `STANDBY | ACTIVE | UPDATING | DELETING | STARTING | STOPPING | ERROR` 

## Errors
<a name="API_StartFlow_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_StartFlow_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/StartFlow) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/StartFlow) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/StartFlow) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/StartFlow) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/StartFlow) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/StartFlow) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/StartFlow) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/StartFlow) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/StartFlow) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/StartFlow) 

# StartRouterInput
<a name="API_StartRouterInput"></a>

Starts a router input in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_StartRouterInput_RequestSyntax"></a>

```
POST /v1/routerInput/start/arn HTTP/1.1
```

## URI Request Parameters
<a name="API_StartRouterInput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_StartRouterInput_RequestSyntax) **   <a name="mediaconnect-StartRouterInput-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router input that you want to start.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_StartRouterInput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_StartRouterInput_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "arn": "string",
   "maintenanceSchedule": { ... },
   "maintenanceScheduleType": "string",
   "name": "string",
   "state": "string"
}
```

## Response Elements
<a name="API_StartRouterInput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [arn](#API_StartRouterInput_ResponseSyntax) **   <a name="mediaconnect-StartRouterInput-response-arn"></a>
The ARN of the router input that was started.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}` 

 ** [maintenanceSchedule](#API_StartRouterInput_ResponseSyntax) **   <a name="mediaconnect-StartRouterInput-response-maintenanceSchedule"></a>
The details of the maintenance schedule for the router input.  
Type: [MaintenanceSchedule](API_MaintenanceSchedule.md) object  
 **Note: **This object is a Union. Only one member of this object can be specified or returned.

 ** [maintenanceScheduleType](#API_StartRouterInput_ResponseSyntax) **   <a name="mediaconnect-StartRouterInput-response-maintenanceScheduleType"></a>
The type of maintenance schedule associated with the router input.  
Type: String  
Valid Values: `WINDOW` 

 ** [name](#API_StartRouterInput_ResponseSyntax) **   <a name="mediaconnect-StartRouterInput-response-name"></a>
The name of the router input that was started.  
Type: String

 ** [state](#API_StartRouterInput_ResponseSyntax) **   <a name="mediaconnect-StartRouterInput-response-state"></a>
The current state of the router input after being started.  
Type: String  
Valid Values: `CREATING | STANDBY | STARTING | ACTIVE | STOPPING | DELETING | UPDATING | ERROR | RECOVERING | MIGRATING` 

## Errors
<a name="API_StartRouterInput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_StartRouterInput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/StartRouterInput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/StartRouterInput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/StartRouterInput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/StartRouterInput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/StartRouterInput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/StartRouterInput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/StartRouterInput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/StartRouterInput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/StartRouterInput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/StartRouterInput) 

# StartRouterOutput
<a name="API_StartRouterOutput"></a>

Starts a router output in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_StartRouterOutput_RequestSyntax"></a>

```
POST /v1/routerOutput/start/arn HTTP/1.1
```

## URI Request Parameters
<a name="API_StartRouterOutput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_StartRouterOutput_RequestSyntax) **   <a name="mediaconnect-StartRouterOutput-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router output that you want to start.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerOutput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_StartRouterOutput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_StartRouterOutput_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "arn": "string",
   "maintenanceSchedule": { ... },
   "maintenanceScheduleType": "string",
   "name": "string",
   "state": "string"
}
```

## Response Elements
<a name="API_StartRouterOutput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [arn](#API_StartRouterOutput_ResponseSyntax) **   <a name="mediaconnect-StartRouterOutput-response-arn"></a>
The Amazon Resource Name (ARN) of the router output that was started.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerOutput:[a-z0-9]{12}` 

 ** [maintenanceSchedule](#API_StartRouterOutput_ResponseSyntax) **   <a name="mediaconnect-StartRouterOutput-response-maintenanceSchedule"></a>
The details of the maintenance schedule for the router output.  
Type: [MaintenanceSchedule](API_MaintenanceSchedule.md) object  
 **Note: **This object is a Union. Only one member of this object can be specified or returned.

 ** [maintenanceScheduleType](#API_StartRouterOutput_ResponseSyntax) **   <a name="mediaconnect-StartRouterOutput-response-maintenanceScheduleType"></a>
The type of maintenance schedule associated with the router output.  
Type: String  
Valid Values: `WINDOW` 

 ** [name](#API_StartRouterOutput_ResponseSyntax) **   <a name="mediaconnect-StartRouterOutput-response-name"></a>
The name of the router output that was started.  
Type: String

 ** [state](#API_StartRouterOutput_ResponseSyntax) **   <a name="mediaconnect-StartRouterOutput-response-state"></a>
The current state of the router output after being started.  
Type: String  
Valid Values: `CREATING | STANDBY | STARTING | ACTIVE | STOPPING | DELETING | UPDATING | ERROR | RECOVERING | MIGRATING` 

## Errors
<a name="API_StartRouterOutput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_StartRouterOutput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/StartRouterOutput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/StartRouterOutput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/StartRouterOutput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/StartRouterOutput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/StartRouterOutput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/StartRouterOutput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/StartRouterOutput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/StartRouterOutput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/StartRouterOutput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/StartRouterOutput) 

# StopFlow
<a name="API_StopFlow"></a>

 Stops a flow.

## Request Syntax
<a name="API_StopFlow_RequestSyntax"></a>

```
POST /v1/flows/stop/flowArn HTTP/1.1
```

## URI Request Parameters
<a name="API_StopFlow_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_StopFlow_RequestSyntax) **   <a name="mediaconnect-StopFlow-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that you want to stop.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

## Request Body
<a name="API_StopFlow_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_StopFlow_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "flowArn": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_StopFlow_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_StopFlow_ResponseSyntax) **   <a name="mediaconnect-StopFlow-response-flowArn"></a>
 The ARN of the flow that you stopped.  
Type: String

 ** [status](#API_StopFlow_ResponseSyntax) **   <a name="mediaconnect-StopFlow-response-status"></a>
 The status of the flow when the `StopFlow` process begins.  
Type: String  
Valid Values: `STANDBY | ACTIVE | UPDATING | DELETING | STARTING | STOPPING | ERROR` 

## Errors
<a name="API_StopFlow_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_StopFlow_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/StopFlow) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/StopFlow) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/StopFlow) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/StopFlow) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/StopFlow) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/StopFlow) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/StopFlow) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/StopFlow) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/StopFlow) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/StopFlow) 

# StopRouterInput
<a name="API_StopRouterInput"></a>

Stops a router input in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_StopRouterInput_RequestSyntax"></a>

```
POST /v1/routerInput/stop/arn HTTP/1.1
```

## URI Request Parameters
<a name="API_StopRouterInput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_StopRouterInput_RequestSyntax) **   <a name="mediaconnect-StopRouterInput-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router input that you want to stop.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_StopRouterInput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_StopRouterInput_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "arn": "string",
   "name": "string",
   "state": "string"
}
```

## Response Elements
<a name="API_StopRouterInput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [arn](#API_StopRouterInput_ResponseSyntax) **   <a name="mediaconnect-StopRouterInput-response-arn"></a>
The ARN of the router input that was stopped.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}` 

 ** [name](#API_StopRouterInput_ResponseSyntax) **   <a name="mediaconnect-StopRouterInput-response-name"></a>
The name of the router input that was stopped.  
Type: String

 ** [state](#API_StopRouterInput_ResponseSyntax) **   <a name="mediaconnect-StopRouterInput-response-state"></a>
The current state of the router input after being stopped.  
Type: String  
Valid Values: `CREATING | STANDBY | STARTING | ACTIVE | STOPPING | DELETING | UPDATING | ERROR | RECOVERING | MIGRATING` 

## Errors
<a name="API_StopRouterInput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_StopRouterInput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/StopRouterInput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/StopRouterInput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/StopRouterInput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/StopRouterInput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/StopRouterInput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/StopRouterInput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/StopRouterInput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/StopRouterInput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/StopRouterInput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/StopRouterInput) 

# StopRouterOutput
<a name="API_StopRouterOutput"></a>

Stops a router output in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_StopRouterOutput_RequestSyntax"></a>

```
POST /v1/routerOutput/stop/arn HTTP/1.1
```

## URI Request Parameters
<a name="API_StopRouterOutput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_StopRouterOutput_RequestSyntax) **   <a name="mediaconnect-StopRouterOutput-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router output that you want to stop.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerOutput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_StopRouterOutput_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_StopRouterOutput_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "arn": "string",
   "name": "string",
   "state": "string"
}
```

## Response Elements
<a name="API_StopRouterOutput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [arn](#API_StopRouterOutput_ResponseSyntax) **   <a name="mediaconnect-StopRouterOutput-response-arn"></a>
The ARN of the router output that was stopped.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerOutput:[a-z0-9]{12}` 

 ** [name](#API_StopRouterOutput_ResponseSyntax) **   <a name="mediaconnect-StopRouterOutput-response-name"></a>
The name of the router output that was stopped.  
Type: String

 ** [state](#API_StopRouterOutput_ResponseSyntax) **   <a name="mediaconnect-StopRouterOutput-response-state"></a>
The current state of the router output after being stopped.  
Type: String  
Valid Values: `CREATING | STANDBY | STARTING | ACTIVE | STOPPING | DELETING | UPDATING | ERROR | RECOVERING | MIGRATING` 

## Errors
<a name="API_StopRouterOutput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_StopRouterOutput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/StopRouterOutput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/StopRouterOutput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/StopRouterOutput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/StopRouterOutput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/StopRouterOutput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/StopRouterOutput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/StopRouterOutput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/StopRouterOutput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/StopRouterOutput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/StopRouterOutput) 

# TagGlobalResource
<a name="API_TagGlobalResource"></a>

Adds tags to a global resource in AWS Elemental MediaConnect. The API supports the following global resources: router inputs, router outputs and router network interfaces. 

## Request Syntax
<a name="API_TagGlobalResource_RequestSyntax"></a>

```
POST /tags/global/resourceArn HTTP/1.1
Content-type: application/json

{
   "tags": { 
      "string" : "string" 
   }
}
```

## URI Request Parameters
<a name="API_TagGlobalResource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [resourceArn](#API_TagGlobalResource_RequestSyntax) **   <a name="mediaconnect-TagGlobalResource-request-uri-resourceArn"></a>
The Amazon Resource Name (ARN) of the global resource to tag.  
Required: Yes

## Request Body
<a name="API_TagGlobalResource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [tags](#API_TagGlobalResource_RequestSyntax) **   <a name="mediaconnect-TagGlobalResource-request-tags"></a>
A map of tag keys and values to add to the global resource.  
Type: String to string map  
Required: Yes

## Response Syntax
<a name="API_TagGlobalResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_TagGlobalResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_TagGlobalResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

## See Also
<a name="API_TagGlobalResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/TagGlobalResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/TagGlobalResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/TagGlobalResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/TagGlobalResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/TagGlobalResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/TagGlobalResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/TagGlobalResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/TagGlobalResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/TagGlobalResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/TagGlobalResource) 

# TagResource
<a name="API_TagResource"></a>

 Associates the specified tags to a resource with the specified `resourceArn` in the current region. If existing tags on a resource are not specified in the request parameters, they are not changed. When a resource is deleted, the tags associated with that resource are deleted as well.

## Request Syntax
<a name="API_TagResource_RequestSyntax"></a>

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

{
   "tags": { 
      "string" : "string" 
   }
}
```

## URI Request Parameters
<a name="API_TagResource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="mediaconnect-TagResource-request-uri-resourceArn"></a>
 The Amazon Resource Name (ARN) that identifies the MediaConnect resource to which to add tags.  
Required: Yes

## Request Body
<a name="API_TagResource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [tags](#API_TagResource_RequestSyntax) **   <a name="mediaconnect-TagResource-request-tags"></a>
 A map from tag keys to values. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.  
Type: String to string map  
Required: Yes

## Response Syntax
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_TagResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_TagResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

## See Also
<a name="API_TagResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/TagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/TagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/TagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/TagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/TagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/TagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/TagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/TagResource) 

# TakeRouterInput
<a name="API_TakeRouterInput"></a>

Associates a router input with a router output in AWS Elemental MediaConnect.

## Request Syntax
<a name="API_TakeRouterInput_RequestSyntax"></a>

```
PUT /v1/routerOutput/takeRouterInput/routerOutputArn HTTP/1.1
Content-type: application/json

{
   "routerInputArn": "string"
}
```

## URI Request Parameters
<a name="API_TakeRouterInput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [routerOutputArn](#API_TakeRouterInput_RequestSyntax) **   <a name="mediaconnect-TakeRouterInput-request-uri-routerOutputArn"></a>
The Amazon Resource Name (ARN) of the router output that you want to associate with a router input.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerOutput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_TakeRouterInput_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [routerInputArn](#API_TakeRouterInput_RequestSyntax) **   <a name="mediaconnect-TakeRouterInput-request-routerInputArn"></a>
The Amazon Resource Name (ARN) of the router input that you want to associate with a router output.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}`   
Required: No

## Response Syntax
<a name="API_TakeRouterInput_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "routedState": "string",
   "routerInputArn": "string",
   "routerInputName": "string",
   "routerOutputArn": "string",
   "routerOutputName": "string"
}
```

## Response Elements
<a name="API_TakeRouterInput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [routedState](#API_TakeRouterInput_ResponseSyntax) **   <a name="mediaconnect-TakeRouterInput-response-routedState"></a>
The state of the association between the router input and output.  
Type: String  
Valid Values: `ROUTED | ROUTING | UNROUTED` 

 ** [routerInputArn](#API_TakeRouterInput_ResponseSyntax) **   <a name="mediaconnect-TakeRouterInput-response-routerInputArn"></a>
The ARN of the associated router input.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}` 

 ** [routerInputName](#API_TakeRouterInput_ResponseSyntax) **   <a name="mediaconnect-TakeRouterInput-response-routerInputName"></a>
The name of the associated router input.  
Type: String

 ** [routerOutputArn](#API_TakeRouterInput_ResponseSyntax) **   <a name="mediaconnect-TakeRouterInput-response-routerOutputArn"></a>
The ARN of the associated router output.  
Type: String  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerOutput:[a-z0-9]{12}` 

 ** [routerOutputName](#API_TakeRouterInput_ResponseSyntax) **   <a name="mediaconnect-TakeRouterInput-response-routerOutputName"></a>
The name of the associated router output.  
Type: String

## Errors
<a name="API_TakeRouterInput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_TakeRouterInput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/TakeRouterInput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/TakeRouterInput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/TakeRouterInput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/TakeRouterInput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/TakeRouterInput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/TakeRouterInput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/TakeRouterInput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/TakeRouterInput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/TakeRouterInput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/TakeRouterInput) 

# UntagGlobalResource
<a name="API_UntagGlobalResource"></a>

Removes tags from a global resource in AWS Elemental MediaConnect. The API supports the following global resources: router inputs, router outputs and router network interfaces. 

## Request Syntax
<a name="API_UntagGlobalResource_RequestSyntax"></a>

```
DELETE /tags/global/resourceArn?tagKeys=tagKeys HTTP/1.1
```

## URI Request Parameters
<a name="API_UntagGlobalResource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [resourceArn](#API_UntagGlobalResource_RequestSyntax) **   <a name="mediaconnect-UntagGlobalResource-request-uri-resourceArn"></a>
The Amazon Resource Name (ARN) of the global resource to remove tags from.  
Required: Yes

 ** [tagKeys](#API_UntagGlobalResource_RequestSyntax) **   <a name="mediaconnect-UntagGlobalResource-request-uri-tagKeys"></a>
The keys of the tags to remove from the global resource.  
Required: Yes

## Request Body
<a name="API_UntagGlobalResource_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_UntagGlobalResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_UntagGlobalResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_UntagGlobalResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

## See Also
<a name="API_UntagGlobalResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UntagGlobalResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UntagGlobalResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UntagGlobalResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UntagGlobalResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UntagGlobalResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UntagGlobalResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UntagGlobalResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UntagGlobalResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UntagGlobalResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UntagGlobalResource) 

# UntagResource
<a name="API_UntagResource"></a>

 Deletes specified tags from a resource in the current region.

## Request Syntax
<a name="API_UntagResource_RequestSyntax"></a>

```
DELETE /tags/resourceArn?tagKeys=tagKeys HTTP/1.1
```

## URI Request Parameters
<a name="API_UntagResource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="mediaconnect-UntagResource-request-uri-resourceArn"></a>
 The Amazon Resource Name (ARN) of the resource that you want to untag.   
Required: Yes

 ** [tagKeys](#API_UntagResource_RequestSyntax) **   <a name="mediaconnect-UntagResource-request-uri-tagKeys"></a>
The keys of the tags to be removed.   
Required: Yes

## Request Body
<a name="API_UntagResource_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_UntagResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.

## Errors
<a name="API_UntagResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

## See Also
<a name="API_UntagResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UntagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UntagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UntagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UntagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UntagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UntagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UntagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UntagResource) 

# UpdateBridge
<a name="API_UpdateBridge"></a>

 Updates the bridge.

## Request Syntax
<a name="API_UpdateBridge_RequestSyntax"></a>

```
PUT /v1/bridges/bridgeArn HTTP/1.1
Content-type: application/json

{
   "egressGatewayBridge": { 
      "maxBitrate": number
   },
   "ingressGatewayBridge": { 
      "maxBitrate": number,
      "maxOutputs": number
   },
   "sourceFailoverConfig": { 
      "failoverMode": "string",
      "recoveryWindow": number,
      "sourcePriority": { 
         "primarySource": "string"
      },
      "state": "string"
   }
}
```

## URI Request Parameters
<a name="API_UpdateBridge_RequestParameters"></a>

The request uses the following URI parameters.

 ** [bridgeArn](#API_UpdateBridge_RequestSyntax) **   <a name="mediaconnect-UpdateBridge-request-uri-bridgeArn"></a>
 TheAmazon Resource Name (ARN) of the bridge that you want to update.   
Pattern: `arn:.+:mediaconnect.+:bridge:.+`   
Required: Yes

## Request Body
<a name="API_UpdateBridge_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [egressGatewayBridge](#API_UpdateBridge_RequestSyntax) **   <a name="mediaconnect-UpdateBridge-request-egressGatewayBridge"></a>
 A cloud-to-ground bridge. The content comes from an existing MediaConnect flow and is delivered to your premises.   
Type: [UpdateEgressGatewayBridgeRequest](API_UpdateEgressGatewayBridgeRequest.md) object  
Required: No

 ** [ingressGatewayBridge](#API_UpdateBridge_RequestSyntax) **   <a name="mediaconnect-UpdateBridge-request-ingressGatewayBridge"></a>
 A ground-to-cloud bridge. The content originates at your premises and is delivered to the cloud.   
Type: [UpdateIngressGatewayBridgeRequest](API_UpdateIngressGatewayBridgeRequest.md) object  
Required: No

 ** [sourceFailoverConfig](#API_UpdateBridge_RequestSyntax) **   <a name="mediaconnect-UpdateBridge-request-sourceFailoverConfig"></a>
 The settings for source failover.   
Type: [UpdateFailoverConfig](API_UpdateFailoverConfig.md) object  
Required: No

## Response Syntax
<a name="API_UpdateBridge_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "bridge": { 
      "bridgeArn": "string",
      "bridgeMessages": [ 
         { 
            "code": "string",
            "message": "string",
            "resourceName": "string"
         }
      ],
      "bridgeState": "string",
      "egressGatewayBridge": { 
         "instanceId": "string",
         "maxBitrate": number
      },
      "ingressGatewayBridge": { 
         "instanceId": "string",
         "maxBitrate": number,
         "maxOutputs": number
      },
      "name": "string",
      "outputs": [ 
         { 
            "flowOutput": { 
               "flowArn": "string",
               "flowSourceArn": "string",
               "name": "string"
            },
            "networkOutput": { 
               "ipAddress": "string",
               "name": "string",
               "networkName": "string",
               "port": number,
               "protocol": "string",
               "ttl": number
            }
         }
      ],
      "placementArn": "string",
      "sourceFailoverConfig": { 
         "failoverMode": "string",
         "recoveryWindow": number,
         "sourcePriority": { 
            "primarySource": "string"
         },
         "state": "string"
      },
      "sources": [ 
         { 
            "flowSource": { 
               "flowArn": "string",
               "flowVpcInterfaceAttachment": { 
                  "vpcInterfaceName": "string"
               },
               "name": "string",
               "outputArn": "string"
            },
            "networkSource": { 
               "multicastIp": "string",
               "multicastSourceSettings": { 
                  "multicastSourceIp": "string"
               },
               "name": "string",
               "networkName": "string",
               "port": number,
               "protocol": "string"
            }
         }
      ]
   }
}
```

## Response Elements
<a name="API_UpdateBridge_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [bridge](#API_UpdateBridge_ResponseSyntax) **   <a name="mediaconnect-UpdateBridge-response-bridge"></a>
 The bridge that was updated.   
Type: [Bridge](API_Bridge.md) object

## Errors
<a name="API_UpdateBridge_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_UpdateBridge_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UpdateBridge) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UpdateBridge) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UpdateBridge) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UpdateBridge) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UpdateBridge) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UpdateBridge) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UpdateBridge) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UpdateBridge) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UpdateBridge) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UpdateBridge) 

# UpdateBridgeOutput
<a name="API_UpdateBridgeOutput"></a>

 Updates an existing bridge output.

## Request Syntax
<a name="API_UpdateBridgeOutput_RequestSyntax"></a>

```
PUT /v1/bridges/bridgeArn/outputs/outputName HTTP/1.1
Content-type: application/json

{
   "networkOutput": { 
      "ipAddress": "string",
      "networkName": "string",
      "port": number,
      "protocol": "string",
      "ttl": number
   }
}
```

## URI Request Parameters
<a name="API_UpdateBridgeOutput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [bridgeArn](#API_UpdateBridgeOutput_RequestSyntax) **   <a name="mediaconnect-UpdateBridgeOutput-request-uri-bridgeArn"></a>
 The Amazon Resource Name (ARN) of the bridge that you want to update.  
Pattern: `arn:.+:mediaconnect.+:bridge:.+`   
Required: Yes

 ** [outputName](#API_UpdateBridgeOutput_RequestSyntax) **   <a name="mediaconnect-UpdateBridgeOutput-request-uri-outputName"></a>
 Tname of the output that you want to update.   
Required: Yes

## Request Body
<a name="API_UpdateBridgeOutput_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [networkOutput](#API_UpdateBridgeOutput_RequestSyntax) **   <a name="mediaconnect-UpdateBridgeOutput-request-networkOutput"></a>
 The network of the bridge output.   
Type: [UpdateBridgeNetworkOutputRequest](API_UpdateBridgeNetworkOutputRequest.md) object  
Required: No

## Response Syntax
<a name="API_UpdateBridgeOutput_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "bridgeArn": "string",
   "output": { 
      "flowOutput": { 
         "flowArn": "string",
         "flowSourceArn": "string",
         "name": "string"
      },
      "networkOutput": { 
         "ipAddress": "string",
         "name": "string",
         "networkName": "string",
         "port": number,
         "protocol": "string",
         "ttl": number
      }
   }
}
```

## Response Elements
<a name="API_UpdateBridgeOutput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [bridgeArn](#API_UpdateBridgeOutput_ResponseSyntax) **   <a name="mediaconnect-UpdateBridgeOutput-response-bridgeArn"></a>
 The ARN of the bridge that was updated.   
Type: String

 ** [output](#API_UpdateBridgeOutput_ResponseSyntax) **   <a name="mediaconnect-UpdateBridgeOutput-response-output"></a>
 The bridge output that was updated.   
Type: [BridgeOutput](API_BridgeOutput.md) object

## Errors
<a name="API_UpdateBridgeOutput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_UpdateBridgeOutput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UpdateBridgeOutput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UpdateBridgeOutput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UpdateBridgeOutput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UpdateBridgeOutput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UpdateBridgeOutput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UpdateBridgeOutput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UpdateBridgeOutput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UpdateBridgeOutput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UpdateBridgeOutput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UpdateBridgeOutput) 

# UpdateBridgeSource
<a name="API_UpdateBridgeSource"></a>

 Updates an existing bridge source.

## Request Syntax
<a name="API_UpdateBridgeSource_RequestSyntax"></a>

```
PUT /v1/bridges/bridgeArn/sources/sourceName HTTP/1.1
Content-type: application/json

{
   "flowSource": { 
      "flowArn": "string",
      "flowVpcInterfaceAttachment": { 
         "vpcInterfaceName": "string"
      }
   },
   "networkSource": { 
      "multicastIp": "string",
      "multicastSourceSettings": { 
         "multicastSourceIp": "string"
      },
      "networkName": "string",
      "port": number,
      "protocol": "string"
   }
}
```

## URI Request Parameters
<a name="API_UpdateBridgeSource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [bridgeArn](#API_UpdateBridgeSource_RequestSyntax) **   <a name="mediaconnect-UpdateBridgeSource-request-uri-bridgeArn"></a>
 The Amazon Resource Name (ARN) of the bridge that you want to update.  
Pattern: `arn:.+:mediaconnect.+:bridge:.+`   
Required: Yes

 ** [sourceName](#API_UpdateBridgeSource_RequestSyntax) **   <a name="mediaconnect-UpdateBridgeSource-request-uri-sourceName"></a>
 The name of the source that you want to update.   
Required: Yes

## Request Body
<a name="API_UpdateBridgeSource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [flowSource](#API_UpdateBridgeSource_RequestSyntax) **   <a name="mediaconnect-UpdateBridgeSource-request-flowSource"></a>
 The name of the flow that you want to update.  
Type: [UpdateBridgeFlowSourceRequest](API_UpdateBridgeFlowSourceRequest.md) object  
Required: No

 ** [networkSource](#API_UpdateBridgeSource_RequestSyntax) **   <a name="mediaconnect-UpdateBridgeSource-request-networkSource"></a>
 The network for the bridge source.   
Type: [UpdateBridgeNetworkSourceRequest](API_UpdateBridgeNetworkSourceRequest.md) object  
Required: No

## Response Syntax
<a name="API_UpdateBridgeSource_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "bridgeArn": "string",
   "source": { 
      "flowSource": { 
         "flowArn": "string",
         "flowVpcInterfaceAttachment": { 
            "vpcInterfaceName": "string"
         },
         "name": "string",
         "outputArn": "string"
      },
      "networkSource": { 
         "multicastIp": "string",
         "multicastSourceSettings": { 
            "multicastSourceIp": "string"
         },
         "name": "string",
         "networkName": "string",
         "port": number,
         "protocol": "string"
      }
   }
}
```

## Response Elements
<a name="API_UpdateBridgeSource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [bridgeArn](#API_UpdateBridgeSource_ResponseSyntax) **   <a name="mediaconnect-UpdateBridgeSource-response-bridgeArn"></a>
 The ARN of the updated bridge source.   
Type: String

 ** [source](#API_UpdateBridgeSource_ResponseSyntax) **   <a name="mediaconnect-UpdateBridgeSource-response-source"></a>
 The updated bridge source.   
Type: [BridgeSource](API_BridgeSource.md) object

## Errors
<a name="API_UpdateBridgeSource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_UpdateBridgeSource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UpdateBridgeSource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UpdateBridgeSource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UpdateBridgeSource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UpdateBridgeSource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UpdateBridgeSource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UpdateBridgeSource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UpdateBridgeSource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UpdateBridgeSource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UpdateBridgeSource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UpdateBridgeSource) 

# UpdateBridgeState
<a name="API_UpdateBridgeState"></a>

 Updates the bridge state. 

## Request Syntax
<a name="API_UpdateBridgeState_RequestSyntax"></a>

```
PUT /v1/bridges/bridgeArn/state HTTP/1.1
Content-type: application/json

{
   "desiredState": "string"
}
```

## URI Request Parameters
<a name="API_UpdateBridgeState_RequestParameters"></a>

The request uses the following URI parameters.

 ** [bridgeArn](#API_UpdateBridgeState_RequestSyntax) **   <a name="mediaconnect-UpdateBridgeState-request-uri-bridgeArn"></a>
 The Amazon Resource Name (ARN) of the bridge that you want to update the state of.   
Pattern: `arn:.+:mediaconnect.+:bridge:.+`   
Required: Yes

## Request Body
<a name="API_UpdateBridgeState_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [desiredState](#API_UpdateBridgeState_RequestSyntax) **   <a name="mediaconnect-UpdateBridgeState-request-desiredState"></a>
 The desired state for the bridge.   
Type: String  
Valid Values: `ACTIVE | STANDBY | DELETED`   
Required: Yes

## Response Syntax
<a name="API_UpdateBridgeState_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "bridgeArn": "string",
   "desiredState": "string"
}
```

## Response Elements
<a name="API_UpdateBridgeState_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [bridgeArn](#API_UpdateBridgeState_ResponseSyntax) **   <a name="mediaconnect-UpdateBridgeState-response-bridgeArn"></a>
The ARN of the updated bridge.   
Type: String

 ** [desiredState](#API_UpdateBridgeState_ResponseSyntax) **   <a name="mediaconnect-UpdateBridgeState-response-desiredState"></a>
 The new state of the bridge.   
Type: String  
Valid Values: `ACTIVE | STANDBY | DELETED` 

## Errors
<a name="API_UpdateBridgeState_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_UpdateBridgeState_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UpdateBridgeState) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UpdateBridgeState) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UpdateBridgeState) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UpdateBridgeState) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UpdateBridgeState) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UpdateBridgeState) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UpdateBridgeState) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UpdateBridgeState) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UpdateBridgeState) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UpdateBridgeState) 

# UpdateFlow
<a name="API_UpdateFlow"></a>

 Updates an existing flow.

**Note**  
 Because `UpdateFlowSources` and `UpdateFlow` are separate operations, you can't change both the source type AND the flow size in a single request.   
If you have a `MEDIUM` flow and you want to change the flow source to NDI®:  
First, use the `UpdateFlow` operation to upgrade the flow size to `LARGE`. 
After that, you can then use the `UpdateFlowSource` operation to configure the NDI source. 
If you're switching from an NDI source to a transport stream (TS) source and want to downgrade the flow size:   
First, use the `UpdateFlowSource` operation to change the flow source type. 
After that, you can then use the `UpdateFlow` operation to downgrade the flow size to `MEDIUM`.

## Request Syntax
<a name="API_UpdateFlow_RequestSyntax"></a>

```
PUT /v1/flows/flowArn HTTP/1.1
Content-type: application/json

{
   "encodingConfig": { 
      "encodingProfile": "string",
      "videoMaxBitrate": number
   },
   "flowSize": "string",
   "maintenance": { 
      "maintenanceDay": "string",
      "maintenanceScheduledDate": "string",
      "maintenanceStartHour": "string"
   },
   "ndiConfig": { 
      "machineName": "string",
      "ndiDiscoveryServers": [ 
         { 
            "discoveryServerAddress": "string",
            "discoveryServerPort": number,
            "vpcInterfaceAdapter": "string"
         }
      ],
      "ndiState": "string"
   },
   "sourceFailoverConfig": { 
      "failoverMode": "string",
      "recoveryWindow": number,
      "sourcePriority": { 
         "primarySource": "string"
      },
      "state": "string"
   },
   "sourceMonitoringConfig": { 
      "audioMonitoringSettings": [ 
         { 
            "silentAudio": { 
               "state": "string",
               "thresholdSeconds": number
            }
         }
      ],
      "contentQualityAnalysisState": "string",
      "thumbnailState": "string",
      "videoMonitoringSettings": [ 
         { 
            "blackFrames": { 
               "state": "string",
               "thresholdSeconds": number
            },
            "frozenFrames": { 
               "state": "string",
               "thresholdSeconds": number
            }
         }
      ]
   }
}
```

## URI Request Parameters
<a name="API_UpdateFlow_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_UpdateFlow_RequestSyntax) **   <a name="mediaconnect-UpdateFlow-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that you want to update.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

## Request Body
<a name="API_UpdateFlow_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [encodingConfig](#API_UpdateFlow_RequestSyntax) **   <a name="mediaconnect-UpdateFlow-request-encodingConfig"></a>
 The encoding configuration to apply to the NDI® source when transcoding it to a transport stream for downstream distribution. You can choose between several predefined encoding profiles based on common use cases.   
Type: [EncodingConfig](API_EncodingConfig.md) object  
Required: No

 ** [flowSize](#API_UpdateFlow_RequestSyntax) **   <a name="mediaconnect-UpdateFlow-request-flowSize"></a>
 Determines the processing capacity and feature set of the flow.   
Type: String  
Valid Values: `MEDIUM | LARGE | LARGE_4X`   
Required: No

 ** [maintenance](#API_UpdateFlow_RequestSyntax) **   <a name="mediaconnect-UpdateFlow-request-maintenance"></a>
 The maintenance setting of the flow.   
Type: [UpdateMaintenance](API_UpdateMaintenance.md) object  
Required: No

 ** [ndiConfig](#API_UpdateFlow_RequestSyntax) **   <a name="mediaconnect-UpdateFlow-request-ndiConfig"></a>
 Specifies the configuration settings for a flow's NDI source or output. Required when the flow includes an NDI source or output.   
Type: [NdiConfig](API_NdiConfig.md) object  
Required: No

 ** [sourceFailoverConfig](#API_UpdateFlow_RequestSyntax) **   <a name="mediaconnect-UpdateFlow-request-sourceFailoverConfig"></a>
 The settings for source failover.   
Type: [UpdateFailoverConfig](API_UpdateFailoverConfig.md) object  
Required: No

 ** [sourceMonitoringConfig](#API_UpdateFlow_RequestSyntax) **   <a name="mediaconnect-UpdateFlow-request-sourceMonitoringConfig"></a>
 The settings for source monitoring.   
Type: [MonitoringConfig](API_MonitoringConfig.md) object  
Required: No

## Response Syntax
<a name="API_UpdateFlow_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "flow": { 
      "availabilityZone": "string",
      "description": "string",
      "egressIp": "string",
      "encodingConfig": { 
         "encodingProfile": "string",
         "videoMaxBitrate": number
      },
      "entitlements": [ 
         { 
            "dataTransferSubscriberFeePercent": number,
            "description": "string",
            "encryption": { 
               "algorithm": "string",
               "constantInitializationVector": "string",
               "deviceId": "string",
               "keyType": "string",
               "region": "string",
               "resourceId": "string",
               "roleArn": "string",
               "secretArn": "string",
               "url": "string"
            },
            "entitlementArn": "string",
            "entitlementStatus": "string",
            "name": "string",
            "subscribers": [ "string" ]
         }
      ],
      "flowArn": "string",
      "flowSize": "string",
      "maintenance": { 
         "maintenanceDay": "string",
         "maintenanceDeadline": "string",
         "maintenanceScheduledDate": "string",
         "maintenanceStartHour": "string"
      },
      "mediaStreams": [ 
         { 
            "attributes": { 
               "fmtp": { 
                  "channelOrder": "string",
                  "colorimetry": "string",
                  "exactFramerate": "string",
                  "par": "string",
                  "range": "string",
                  "scanMode": "string",
                  "tcs": "string"
               },
               "lang": "string"
            },
            "clockRate": number,
            "description": "string",
            "fmt": number,
            "mediaStreamId": number,
            "mediaStreamName": "string",
            "mediaStreamType": "string",
            "videoFormat": "string"
         }
      ],
      "name": "string",
      "ndiConfig": { 
         "machineName": "string",
         "ndiDiscoveryServers": [ 
            { 
               "discoveryServerAddress": "string",
               "discoveryServerPort": number,
               "vpcInterfaceAdapter": "string"
            }
         ],
         "ndiState": "string"
      },
      "outputs": [ 
         { 
            "bridgeArn": "string",
            "bridgePorts": [ number ],
            "connectedRouterInputArn": "string",
            "dataTransferSubscriberFeePercent": number,
            "description": "string",
            "destination": "string",
            "encryption": { 
               "algorithm": "string",
               "constantInitializationVector": "string",
               "deviceId": "string",
               "keyType": "string",
               "region": "string",
               "resourceId": "string",
               "roleArn": "string",
               "secretArn": "string",
               "url": "string"
            },
            "entitlementArn": "string",
            "listenerAddress": "string",
            "mediaLiveInputArn": "string",
            "mediaStreamOutputConfigurations": [ 
               { 
                  "destinationConfigurations": [ 
                     { 
                        "destinationIp": "string",
                        "destinationPort": number,
                        "interface": { 
                           "name": "string"
                        },
                        "outboundIp": "string"
                     }
                  ],
                  "encodingName": "string",
                  "encodingParameters": { 
                     "compressionFactor": number,
                     "encoderProfile": "string"
                  },
                  "mediaStreamName": "string"
               }
            ],
            "name": "string",
            "outputArn": "string",
            "outputStatus": "string",
            "peerIpAddress": "string",
            "port": number,
            "routerIntegrationState": "string",
            "routerIntegrationTransitEncryption": { 
               "encryptionKeyConfiguration": { ... },
               "encryptionKeyType": "string"
            },
            "transport": { 
               "cidrAllowList": [ "string" ],
               "maxBitrate": number,
               "maxLatency": number,
               "maxSyncBuffer": number,
               "minLatency": number,
               "ndiProgramName": "string",
               "ndiSourceSettings": { 
                  "sourceName": "string"
               },
               "ndiSpeedHqQuality": number,
               "protocol": "string",
               "remoteId": "string",
               "senderControlPort": number,
               "senderIpAddress": "string",
               "smoothingLatency": number,
               "sourceListenerAddress": "string",
               "sourceListenerPort": number,
               "streamId": "string"
            },
            "vpcInterfaceAttachment": { 
               "vpcInterfaceName": "string"
            }
         }
      ],
      "source": { 
         "connectedRouterOutputArn": "string",
         "dataTransferSubscriberFeePercent": number,
         "decryption": { 
            "algorithm": "string",
            "constantInitializationVector": "string",
            "deviceId": "string",
            "keyType": "string",
            "region": "string",
            "resourceId": "string",
            "roleArn": "string",
            "secretArn": "string",
            "url": "string"
         },
         "description": "string",
         "entitlementArn": "string",
         "gatewayBridgeSource": { 
            "bridgeArn": "string",
            "vpcInterfaceAttachment": { 
               "vpcInterfaceName": "string"
            }
         },
         "ingestIp": "string",
         "ingestPort": number,
         "mediaStreamSourceConfigurations": [ 
            { 
               "encodingName": "string",
               "inputConfigurations": [ 
                  { 
                     "inputIp": "string",
                     "inputPort": number,
                     "interface": { 
                        "name": "string"
                     }
                  }
               ],
               "mediaStreamName": "string"
            }
         ],
         "name": "string",
         "peerIpAddress": "string",
         "routerIntegrationState": "string",
         "routerIntegrationTransitDecryption": { 
            "encryptionKeyConfiguration": { ... },
            "encryptionKeyType": "string"
         },
         "senderControlPort": number,
         "senderIpAddress": "string",
         "sourceArn": "string",
         "transport": { 
            "cidrAllowList": [ "string" ],
            "maxBitrate": number,
            "maxLatency": number,
            "maxSyncBuffer": number,
            "minLatency": number,
            "ndiProgramName": "string",
            "ndiSourceSettings": { 
               "sourceName": "string"
            },
            "ndiSpeedHqQuality": number,
            "protocol": "string",
            "remoteId": "string",
            "senderControlPort": number,
            "senderIpAddress": "string",
            "smoothingLatency": number,
            "sourceListenerAddress": "string",
            "sourceListenerPort": number,
            "streamId": "string"
         },
         "vpcInterfaceName": "string",
         "whitelistCidr": "string"
      },
      "sourceFailoverConfig": { 
         "failoverMode": "string",
         "recoveryWindow": number,
         "sourcePriority": { 
            "primarySource": "string"
         },
         "state": "string"
      },
      "sourceMonitoringConfig": { 
         "audioMonitoringSettings": [ 
            { 
               "silentAudio": { 
                  "state": "string",
                  "thresholdSeconds": number
               }
            }
         ],
         "contentQualityAnalysisState": "string",
         "thumbnailState": "string",
         "videoMonitoringSettings": [ 
            { 
               "blackFrames": { 
                  "state": "string",
                  "thresholdSeconds": number
               },
               "frozenFrames": { 
                  "state": "string",
                  "thresholdSeconds": number
               }
            }
         ]
      },
      "sources": [ 
         { 
            "connectedRouterOutputArn": "string",
            "dataTransferSubscriberFeePercent": number,
            "decryption": { 
               "algorithm": "string",
               "constantInitializationVector": "string",
               "deviceId": "string",
               "keyType": "string",
               "region": "string",
               "resourceId": "string",
               "roleArn": "string",
               "secretArn": "string",
               "url": "string"
            },
            "description": "string",
            "entitlementArn": "string",
            "gatewayBridgeSource": { 
               "bridgeArn": "string",
               "vpcInterfaceAttachment": { 
                  "vpcInterfaceName": "string"
               }
            },
            "ingestIp": "string",
            "ingestPort": number,
            "mediaStreamSourceConfigurations": [ 
               { 
                  "encodingName": "string",
                  "inputConfigurations": [ 
                     { 
                        "inputIp": "string",
                        "inputPort": number,
                        "interface": { 
                           "name": "string"
                        }
                     }
                  ],
                  "mediaStreamName": "string"
               }
            ],
            "name": "string",
            "peerIpAddress": "string",
            "routerIntegrationState": "string",
            "routerIntegrationTransitDecryption": { 
               "encryptionKeyConfiguration": { ... },
               "encryptionKeyType": "string"
            },
            "senderControlPort": number,
            "senderIpAddress": "string",
            "sourceArn": "string",
            "transport": { 
               "cidrAllowList": [ "string" ],
               "maxBitrate": number,
               "maxLatency": number,
               "maxSyncBuffer": number,
               "minLatency": number,
               "ndiProgramName": "string",
               "ndiSourceSettings": { 
                  "sourceName": "string"
               },
               "ndiSpeedHqQuality": number,
               "protocol": "string",
               "remoteId": "string",
               "senderControlPort": number,
               "senderIpAddress": "string",
               "smoothingLatency": number,
               "sourceListenerAddress": "string",
               "sourceListenerPort": number,
               "streamId": "string"
            },
            "vpcInterfaceName": "string",
            "whitelistCidr": "string"
         }
      ],
      "status": "string",
      "vpcInterfaces": [ 
         { 
            "name": "string",
            "networkInterfaceIds": [ "string" ],
            "networkInterfaceType": "string",
            "roleArn": "string",
            "securityGroupIds": [ "string" ],
            "subnetId": "string"
         }
      ]
   }
}
```

## Response Elements
<a name="API_UpdateFlow_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [flow](#API_UpdateFlow_ResponseSyntax) **   <a name="mediaconnect-UpdateFlow-response-flow"></a>
 The updated flow.   
Type: [Flow](API_Flow.md) object

## Errors
<a name="API_UpdateFlow_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_UpdateFlow_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UpdateFlow) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UpdateFlow) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UpdateFlow) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UpdateFlow) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UpdateFlow) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UpdateFlow) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UpdateFlow) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UpdateFlow) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UpdateFlow) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UpdateFlow) 

# UpdateFlowEntitlement
<a name="API_UpdateFlowEntitlement"></a>

 Updates an entitlement. You can change an entitlement's description, subscribers, and encryption. If you change the subscribers, the service will remove the outputs that are are used by the subscribers that are removed.

## Request Syntax
<a name="API_UpdateFlowEntitlement_RequestSyntax"></a>

```
PUT /v1/flows/flowArn/entitlements/entitlementArn HTTP/1.1
Content-type: application/json

{
   "description": "string",
   "encryption": { 
      "algorithm": "string",
      "constantInitializationVector": "string",
      "deviceId": "string",
      "keyType": "string",
      "region": "string",
      "resourceId": "string",
      "roleArn": "string",
      "secretArn": "string",
      "url": "string"
   },
   "entitlementStatus": "string",
   "subscribers": [ "string" ]
}
```

## URI Request Parameters
<a name="API_UpdateFlowEntitlement_RequestParameters"></a>

The request uses the following URI parameters.

 ** [entitlementArn](#API_UpdateFlowEntitlement_RequestSyntax) **   <a name="mediaconnect-UpdateFlowEntitlement-request-uri-entitlementArn"></a>
 The Amazon Resource Name (ARN) of the entitlement that you want to update.  
Pattern: `arn:.+:mediaconnect.+:entitlement:.+`   
Required: Yes

 ** [flowArn](#API_UpdateFlowEntitlement_RequestSyntax) **   <a name="mediaconnect-UpdateFlowEntitlement-request-uri-flowArn"></a>
 The ARN of the flow that is associated with the entitlement that you want to update.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

## Request Body
<a name="API_UpdateFlowEntitlement_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [description](#API_UpdateFlowEntitlement_RequestSyntax) **   <a name="mediaconnect-UpdateFlowEntitlement-request-description"></a>
 A description of the entitlement. This description appears only on the MediaConnect console and will not be seen by the subscriber or end user.  
Type: String  
Required: No

 ** [encryption](#API_UpdateFlowEntitlement_RequestSyntax) **   <a name="mediaconnect-UpdateFlowEntitlement-request-encryption"></a>
 The type of encryption that will be used on the output associated with this entitlement. Allowable encryption types: static-key, speke.  
Type: [UpdateEncryption](API_UpdateEncryption.md) object  
Required: No

 ** [entitlementStatus](#API_UpdateFlowEntitlement_RequestSyntax) **   <a name="mediaconnect-UpdateFlowEntitlement-request-entitlementStatus"></a>
 An indication of whether you want to enable the entitlement to allow access, or disable it to stop streaming content to the subscriber’s flow temporarily. If you don’t specify the `entitlementStatus` field in your request, MediaConnect leaves the value unchanged.  
Type: String  
Valid Values: `ENABLED | DISABLED`   
Required: No

 ** [subscribers](#API_UpdateFlowEntitlement_RequestSyntax) **   <a name="mediaconnect-UpdateFlowEntitlement-request-subscribers"></a>
 The AWS account IDs that you want to share your content with. The receiving accounts (subscribers) will be allowed to create their own flow using your content as the source.  
Type: Array of strings  
Required: No

## Response Syntax
<a name="API_UpdateFlowEntitlement_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "entitlement": { 
      "dataTransferSubscriberFeePercent": number,
      "description": "string",
      "encryption": { 
         "algorithm": "string",
         "constantInitializationVector": "string",
         "deviceId": "string",
         "keyType": "string",
         "region": "string",
         "resourceId": "string",
         "roleArn": "string",
         "secretArn": "string",
         "url": "string"
      },
      "entitlementArn": "string",
      "entitlementStatus": "string",
      "name": "string",
      "subscribers": [ "string" ]
   },
   "flowArn": "string"
}
```

## Response Elements
<a name="API_UpdateFlowEntitlement_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [entitlement](#API_UpdateFlowEntitlement_ResponseSyntax) **   <a name="mediaconnect-UpdateFlowEntitlement-response-entitlement"></a>
 The new configuration of the entitlement that you updated.  
Type: [Entitlement](API_Entitlement.md) object

 ** [flowArn](#API_UpdateFlowEntitlement_ResponseSyntax) **   <a name="mediaconnect-UpdateFlowEntitlement-response-flowArn"></a>
 The ARN of the flow that this entitlement was granted on.  
Type: String

## Errors
<a name="API_UpdateFlowEntitlement_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_UpdateFlowEntitlement_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UpdateFlowEntitlement) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UpdateFlowEntitlement) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UpdateFlowEntitlement) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UpdateFlowEntitlement) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UpdateFlowEntitlement) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UpdateFlowEntitlement) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UpdateFlowEntitlement) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UpdateFlowEntitlement) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UpdateFlowEntitlement) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UpdateFlowEntitlement) 

# UpdateFlowMediaStream
<a name="API_UpdateFlowMediaStream"></a>

 Updates an existing media stream.

## Request Syntax
<a name="API_UpdateFlowMediaStream_RequestSyntax"></a>

```
PUT /v1/flows/flowArn/mediaStreams/mediaStreamName HTTP/1.1
Content-type: application/json

{
   "attributes": { 
      "fmtp": { 
         "channelOrder": "string",
         "colorimetry": "string",
         "exactFramerate": "string",
         "par": "string",
         "range": "string",
         "scanMode": "string",
         "tcs": "string"
      },
      "lang": "string"
   },
   "clockRate": number,
   "description": "string",
   "mediaStreamType": "string",
   "videoFormat": "string"
}
```

## URI Request Parameters
<a name="API_UpdateFlowMediaStream_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_UpdateFlowMediaStream_RequestSyntax) **   <a name="mediaconnect-UpdateFlowMediaStream-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that is associated with the media stream that you updated.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

 ** [mediaStreamName](#API_UpdateFlowMediaStream_RequestSyntax) **   <a name="mediaconnect-UpdateFlowMediaStream-request-uri-mediaStreamName"></a>
 The media stream that you updated.  
Required: Yes

## Request Body
<a name="API_UpdateFlowMediaStream_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [attributes](#API_UpdateFlowMediaStream_RequestSyntax) **   <a name="mediaconnect-UpdateFlowMediaStream-request-attributes"></a>
 The attributes that you want to assign to the media stream.  
Type: [MediaStreamAttributesRequest](API_MediaStreamAttributesRequest.md) object  
Required: No

 ** [clockRate](#API_UpdateFlowMediaStream_RequestSyntax) **   <a name="mediaconnect-UpdateFlowMediaStream-request-clockRate"></a>
The sample rate for the stream. This value in measured in kHz.   
Type: Integer  
Required: No

 ** [description](#API_UpdateFlowMediaStream_RequestSyntax) **   <a name="mediaconnect-UpdateFlowMediaStream-request-description"></a>
A description that can help you quickly identify what your media stream is used for.   
Type: String  
Required: No

 ** [mediaStreamType](#API_UpdateFlowMediaStream_RequestSyntax) **   <a name="mediaconnect-UpdateFlowMediaStream-request-mediaStreamType"></a>
The type of media stream.   
Type: String  
Valid Values: `video | audio | ancillary-data`   
Required: No

 ** [videoFormat](#API_UpdateFlowMediaStream_RequestSyntax) **   <a name="mediaconnect-UpdateFlowMediaStream-request-videoFormat"></a>
The resolution of the video.   
Type: String  
Required: No

## Response Syntax
<a name="API_UpdateFlowMediaStream_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "flowArn": "string",
   "mediaStream": { 
      "attributes": { 
         "fmtp": { 
            "channelOrder": "string",
            "colorimetry": "string",
            "exactFramerate": "string",
            "par": "string",
            "range": "string",
            "scanMode": "string",
            "tcs": "string"
         },
         "lang": "string"
      },
      "clockRate": number,
      "description": "string",
      "fmt": number,
      "mediaStreamId": number,
      "mediaStreamName": "string",
      "mediaStreamType": "string",
      "videoFormat": "string"
   }
}
```

## Response Elements
<a name="API_UpdateFlowMediaStream_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_UpdateFlowMediaStream_ResponseSyntax) **   <a name="mediaconnect-UpdateFlowMediaStream-response-flowArn"></a>
The ARN of the flow that is associated with the media stream that you updated.   
Type: String

 ** [mediaStream](#API_UpdateFlowMediaStream_ResponseSyntax) **   <a name="mediaconnect-UpdateFlowMediaStream-response-mediaStream"></a>
The media stream that you updated.   
Type: [MediaStream](API_MediaStream.md) object

## Errors
<a name="API_UpdateFlowMediaStream_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_UpdateFlowMediaStream_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UpdateFlowMediaStream) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UpdateFlowMediaStream) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UpdateFlowMediaStream) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UpdateFlowMediaStream) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UpdateFlowMediaStream) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UpdateFlowMediaStream) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UpdateFlowMediaStream) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UpdateFlowMediaStream) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UpdateFlowMediaStream) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UpdateFlowMediaStream) 

# UpdateFlowOutput
<a name="API_UpdateFlowOutput"></a>

 Updates an existing flow output.

## Request Syntax
<a name="API_UpdateFlowOutput_RequestSyntax"></a>

```
PUT /v1/flows/flowArn/outputs/outputArn HTTP/1.1
Content-type: application/json

{
   "cidrAllowList": [ "string" ],
   "description": "string",
   "destination": "string",
   "encryption": { 
      "algorithm": "string",
      "constantInitializationVector": "string",
      "deviceId": "string",
      "keyType": "string",
      "region": "string",
      "resourceId": "string",
      "roleArn": "string",
      "secretArn": "string",
      "url": "string"
   },
   "maxLatency": number,
   "mediaStreamOutputConfigurations": [ 
      { 
         "destinationConfigurations": [ 
            { 
               "destinationIp": "string",
               "destinationPort": number,
               "interface": { 
                  "name": "string"
               }
            }
         ],
         "encodingName": "string",
         "encodingParameters": { 
            "compressionFactor": number,
            "encoderProfile": "string"
         },
         "mediaStreamName": "string"
      }
   ],
   "minLatency": number,
   "ndiProgramName": "string",
   "ndiSpeedHqQuality": number,
   "outputStatus": "string",
   "port": number,
   "protocol": "string",
   "remoteId": "string",
   "routerIntegrationState": "string",
   "routerIntegrationTransitEncryption": { 
      "encryptionKeyConfiguration": { ... },
      "encryptionKeyType": "string"
   },
   "senderControlPort": number,
   "senderIpAddress": "string",
   "smoothingLatency": number,
   "streamId": "string",
   "vpcInterfaceAttachment": { 
      "vpcInterfaceName": "string"
   }
}
```

## URI Request Parameters
<a name="API_UpdateFlowOutput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-uri-flowArn"></a>
 The Amazon Resource Name (ARN) of the flow that is associated with the output that you want to update.  
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

 ** [outputArn](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-uri-outputArn"></a>
 The ARN of the output that you want to update.  
Pattern: `arn:.+:mediaconnect.+:output:.+`   
Required: Yes

## Request Body
<a name="API_UpdateFlowOutput_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [cidrAllowList](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-cidrAllowList"></a>
 The range of IP addresses that should be allowed to initiate output requests to this flow. These IP addresses should be in the form of a Classless Inter-Domain Routing (CIDR) block; for example, 10.0.0.0/16.  
Type: Array of strings  
Required: No

 ** [description](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-description"></a>
 A description of the output. This description appears only on the MediaConnect console and will not be seen by the end user.  
Type: String  
Required: No

 ** [destination](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-destination"></a>
 The IP address where you want to send the output.  
Type: String  
Required: No

 ** [encryption](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-encryption"></a>
 The type of key used for the encryption. If no `keyType` is provided, the service will use the default setting (static-key). Allowable encryption types: static-key.  
Type: [UpdateEncryption](API_UpdateEncryption.md) object  
Required: No

 ** [maxLatency](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-maxLatency"></a>
 The maximum latency in milliseconds. This parameter applies only to RIST-based and Zixi-based streams.  
Type: Integer  
Required: No

 ** [mediaStreamOutputConfigurations](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-mediaStreamOutputConfigurations"></a>
 The media streams that are associated with the output, and the parameters for those associations.  
Type: Array of [MediaStreamOutputConfigurationRequest](API_MediaStreamOutputConfigurationRequest.md) objects  
Required: No

 ** [minLatency](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-minLatency"></a>
 The minimum latency in milliseconds for SRT-based streams. In streams that use the SRT protocol, this value that you set on your MediaConnect source or output represents the minimal potential latency of that connection. The latency of the stream is set to the highest number between the sender’s minimum latency and the receiver’s minimum latency.  
Type: Integer  
Required: No

 ** [ndiProgramName](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-ndiProgramName"></a>
 A suffix for the name of the NDI® sender that the flow creates. If a custom name isn't specified, MediaConnect uses the output name.   
Type: String  
Required: No

 ** [ndiSpeedHqQuality](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-ndiSpeedHqQuality"></a>
A quality setting for the NDI Speed HQ encoder.   
Type: Integer  
Required: No

 ** [outputStatus](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-outputStatus"></a>
 An indication of whether the output should transmit data or not. If you don't specify the `outputStatus` field in your request, MediaConnect leaves the value unchanged.  
Type: String  
Valid Values: `ENABLED | DISABLED`   
Required: No

 ** [port](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-port"></a>
 The port to use when content is distributed to this output.  
Type: Integer  
Required: No

 ** [protocol](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-protocol"></a>
 The protocol to use for the output.  
 AWS Elemental MediaConnect no longer supports the Fujitsu QoS protocol. This reference is maintained for legacy purposes only.
Type: String  
Valid Values: `zixi-push | rtp-fec | rtp | zixi-pull | rist | st2110-jpegxs | cdi | srt-listener | srt-caller | fujitsu-qos | udp | ndi-speed-hq`   
Required: No

 ** [remoteId](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-remoteId"></a>
 The remote ID for the Zixi-pull stream.  
Type: String  
Required: No

 ** [routerIntegrationState](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-routerIntegrationState"></a>
Indicates whether to enable or disable router integration for this flow output.  
Type: String  
Valid Values: `ENABLED | DISABLED`   
Required: No

 ** [routerIntegrationTransitEncryption](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-routerIntegrationTransitEncryption"></a>
The configuration that defines how content is encrypted during transit between the MediaConnect router and a MediaConnect flow.  
Type: [FlowTransitEncryption](API_FlowTransitEncryption.md) object  
Required: No

 ** [senderControlPort](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-senderControlPort"></a>
 The port that the flow uses to send outbound requests to initiate connection with the sender.  
Type: Integer  
Required: No

 ** [senderIpAddress](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-senderIpAddress"></a>
 The IP address that the flow communicates with to initiate connection with the sender.  
Type: String  
Required: No

 ** [smoothingLatency](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-smoothingLatency"></a>
 The smoothing latency in milliseconds for RIST, RTP, and RTP-FEC streams.  
Type: Integer  
Required: No

 ** [streamId](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-streamId"></a>
 The stream ID that you want to use for this transport. This parameter applies only to Zixi and SRT caller-based streams.  
Type: String  
Required: No

 ** [vpcInterfaceAttachment](#API_UpdateFlowOutput_RequestSyntax) **   <a name="mediaconnect-UpdateFlowOutput-request-vpcInterfaceAttachment"></a>
 The name of the VPC interface attachment to use for this output.  
Type: [VpcInterfaceAttachment](API_VpcInterfaceAttachment.md) object  
Required: No

## Response Syntax
<a name="API_UpdateFlowOutput_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "flowArn": "string",
   "output": { 
      "bridgeArn": "string",
      "bridgePorts": [ number ],
      "connectedRouterInputArn": "string",
      "dataTransferSubscriberFeePercent": number,
      "description": "string",
      "destination": "string",
      "encryption": { 
         "algorithm": "string",
         "constantInitializationVector": "string",
         "deviceId": "string",
         "keyType": "string",
         "region": "string",
         "resourceId": "string",
         "roleArn": "string",
         "secretArn": "string",
         "url": "string"
      },
      "entitlementArn": "string",
      "listenerAddress": "string",
      "mediaLiveInputArn": "string",
      "mediaStreamOutputConfigurations": [ 
         { 
            "destinationConfigurations": [ 
               { 
                  "destinationIp": "string",
                  "destinationPort": number,
                  "interface": { 
                     "name": "string"
                  },
                  "outboundIp": "string"
               }
            ],
            "encodingName": "string",
            "encodingParameters": { 
               "compressionFactor": number,
               "encoderProfile": "string"
            },
            "mediaStreamName": "string"
         }
      ],
      "name": "string",
      "outputArn": "string",
      "outputStatus": "string",
      "peerIpAddress": "string",
      "port": number,
      "routerIntegrationState": "string",
      "routerIntegrationTransitEncryption": { 
         "encryptionKeyConfiguration": { ... },
         "encryptionKeyType": "string"
      },
      "transport": { 
         "cidrAllowList": [ "string" ],
         "maxBitrate": number,
         "maxLatency": number,
         "maxSyncBuffer": number,
         "minLatency": number,
         "ndiProgramName": "string",
         "ndiSourceSettings": { 
            "sourceName": "string"
         },
         "ndiSpeedHqQuality": number,
         "protocol": "string",
         "remoteId": "string",
         "senderControlPort": number,
         "senderIpAddress": "string",
         "smoothingLatency": number,
         "sourceListenerAddress": "string",
         "sourceListenerPort": number,
         "streamId": "string"
      },
      "vpcInterfaceAttachment": { 
         "vpcInterfaceName": "string"
      }
   }
}
```

## Response Elements
<a name="API_UpdateFlowOutput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_UpdateFlowOutput_ResponseSyntax) **   <a name="mediaconnect-UpdateFlowOutput-response-flowArn"></a>
 The ARN of the flow that is associated with the updated output.  
Type: String

 ** [output](#API_UpdateFlowOutput_ResponseSyntax) **   <a name="mediaconnect-UpdateFlowOutput-response-output"></a>
 The new settings of the output that you updated.  
Type: [Output](API_Output.md) object

## Errors
<a name="API_UpdateFlowOutput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_UpdateFlowOutput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UpdateFlowOutput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UpdateFlowOutput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UpdateFlowOutput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UpdateFlowOutput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UpdateFlowOutput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UpdateFlowOutput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UpdateFlowOutput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UpdateFlowOutput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UpdateFlowOutput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UpdateFlowOutput) 

# UpdateFlowSource
<a name="API_UpdateFlowSource"></a>

 Updates the source of a flow.

**Note**  
 Because `UpdateFlowSources` and `UpdateFlow` are separate operations, you can't change both the source type AND the flow size in a single request.   
If you have a `MEDIUM` flow and you want to change the flow source to NDI®:  
First, use the `UpdateFlow` operation to upgrade the flow size to `LARGE`. 
After that, you can then use the `UpdateFlowSource` operation to configure the NDI source. 
If you're switching from an NDI source to a transport stream (TS) source and want to downgrade the flow size:   
First, use the `UpdateFlowSource` operation to change the flow source type. 
After that, you can then use the `UpdateFlow` operation to downgrade the flow size to `MEDIUM`.

## Request Syntax
<a name="API_UpdateFlowSource_RequestSyntax"></a>

```
PUT /v1/flows/flowArn/source/sourceArn HTTP/1.1
Content-type: application/json

{
   "decryption": { 
      "algorithm": "string",
      "constantInitializationVector": "string",
      "deviceId": "string",
      "keyType": "string",
      "region": "string",
      "resourceId": "string",
      "roleArn": "string",
      "secretArn": "string",
      "url": "string"
   },
   "description": "string",
   "entitlementArn": "string",
   "gatewayBridgeSource": { 
      "bridgeArn": "string",
      "vpcInterfaceAttachment": { 
         "vpcInterfaceName": "string"
      }
   },
   "ingestPort": number,
   "maxBitrate": number,
   "maxLatency": number,
   "maxSyncBuffer": number,
   "mediaStreamSourceConfigurations": [ 
      { 
         "encodingName": "string",
         "inputConfigurations": [ 
            { 
               "inputPort": number,
               "interface": { 
                  "name": "string"
               }
            }
         ],
         "mediaStreamName": "string"
      }
   ],
   "minLatency": number,
   "ndiSourceSettings": { 
      "sourceName": "string"
   },
   "protocol": "string",
   "routerIntegrationState": "string",
   "routerIntegrationTransitDecryption": { 
      "encryptionKeyConfiguration": { ... },
      "encryptionKeyType": "string"
   },
   "senderControlPort": number,
   "senderIpAddress": "string",
   "sourceListenerAddress": "string",
   "sourceListenerPort": number,
   "streamId": "string",
   "vpcInterfaceName": "string",
   "whitelistCidr": "string"
}
```

## URI Request Parameters
<a name="API_UpdateFlowSource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [flowArn](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-uri-flowArn"></a>
 The ARN of the flow that you want to update.   
Pattern: `arn:.+:mediaconnect.+:flow:.+`   
Required: Yes

 ** [sourceArn](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-uri-sourceArn"></a>
The ARN of the source that you want to update.   
Pattern: `arn:.+:mediaconnect.+:source:.+`   
Required: Yes

## Request Body
<a name="API_UpdateFlowSource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [decryption](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-decryption"></a>
The type of encryption that is used on the content ingested from the source.   
Type: [UpdateEncryption](API_UpdateEncryption.md) object  
Required: No

 ** [description](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-description"></a>
A description of the source. This description is not visible outside of the current AWS account.   
Type: String  
Required: No

 ** [entitlementArn](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-entitlementArn"></a>
The Amazon Resource Name (ARN) of the entitlement that allows you to subscribe to the flow. The entitlement is set by the content originator, and the ARN is generated as part of the originator's flow.   
Type: String  
Pattern: `arn:.+:mediaconnect.+:entitlement:.+`   
Required: No

 ** [gatewayBridgeSource](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-gatewayBridgeSource"></a>
The source configuration for cloud flows receiving a stream from a bridge.   
Type: [UpdateGatewayBridgeSourceRequest](API_UpdateGatewayBridgeSourceRequest.md) object  
Required: No

 ** [ingestPort](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-ingestPort"></a>
The port that the flow listens on for incoming content. If the protocol of the source is Zixi, the port must be set to 2088.   
Type: Integer  
Required: No

 ** [maxBitrate](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-maxBitrate"></a>
The maximum bitrate for RIST, RTP, and RTP-FEC streams.   
Type: Integer  
Required: No

 ** [maxLatency](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-maxLatency"></a>
The maximum latency in milliseconds. This parameter applies only to RIST-based and Zixi-based streams.   
Type: Integer  
Required: No

 ** [maxSyncBuffer](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-maxSyncBuffer"></a>
The size of the buffer (in milliseconds) to use to sync incoming source data.   
Type: Integer  
Required: No

 ** [mediaStreamSourceConfigurations](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-mediaStreamSourceConfigurations"></a>
The media stream that is associated with the source, and the parameters for that association.   
Type: Array of [MediaStreamSourceConfigurationRequest](API_MediaStreamSourceConfigurationRequest.md) objects  
Required: No

 ** [minLatency](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-minLatency"></a>
The minimum latency in milliseconds for SRT-based streams. In streams that use the SRT protocol, this value that you set on your MediaConnect source or output represents the minimal potential latency of that connection. The latency of the stream is set to the highest number between the sender’s minimum latency and the receiver’s minimum latency.   
Type: Integer  
Required: No

 ** [ndiSourceSettings](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-ndiSourceSettings"></a>
 The settings for the NDI source. This includes the exact name of the upstream NDI sender that you want to connect to your source.   
Type: [NdiSourceSettings](API_NdiSourceSettings.md) object  
Required: No

 ** [protocol](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-protocol"></a>
The protocol that the source uses to deliver the content to MediaConnect.   
 AWS Elemental MediaConnect no longer supports the Fujitsu QoS protocol. This reference is maintained for legacy purposes only.
Type: String  
Valid Values: `zixi-push | rtp-fec | rtp | zixi-pull | rist | st2110-jpegxs | cdi | srt-listener | srt-caller | fujitsu-qos | udp | ndi-speed-hq`   
Required: No

 ** [routerIntegrationState](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-routerIntegrationState"></a>
Indicates whether to enable or disable router integration for this flow source.  
Type: String  
Valid Values: `ENABLED | DISABLED`   
Required: No

 ** [routerIntegrationTransitDecryption](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-routerIntegrationTransitDecryption"></a>
The encryption configuration for the flow source when router integration is enabled.  
Type: [FlowTransitEncryption](API_FlowTransitEncryption.md) object  
Required: No

 ** [senderControlPort](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-senderControlPort"></a>
The port that the flow uses to send outbound requests to initiate connection with the sender.   
Type: Integer  
Required: No

 ** [senderIpAddress](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-senderIpAddress"></a>
The IP address that the flow communicates with to initiate connection with the sender.   
Type: String  
Required: No

 ** [sourceListenerAddress](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-sourceListenerAddress"></a>
The source IP or domain name for SRT-caller protocol.   
Type: String  
Required: No

 ** [sourceListenerPort](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-sourceListenerPort"></a>
Source port for SRT-caller protocol.   
Type: Integer  
Required: No

 ** [streamId](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-streamId"></a>
The stream ID that you want to use for this transport. This parameter applies only to Zixi and SRT caller-based streams.   
Type: String  
Required: No

 ** [vpcInterfaceName](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-vpcInterfaceName"></a>
The name of the VPC interface that you want to send your output to.  
Type: String  
Required: No

 ** [whitelistCidr](#API_UpdateFlowSource_RequestSyntax) **   <a name="mediaconnect-UpdateFlowSource-request-whitelistCidr"></a>
The 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.0.0.0/16.   
Type: String  
Required: No

## Response Syntax
<a name="API_UpdateFlowSource_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "flowArn": "string",
   "source": { 
      "connectedRouterOutputArn": "string",
      "dataTransferSubscriberFeePercent": number,
      "decryption": { 
         "algorithm": "string",
         "constantInitializationVector": "string",
         "deviceId": "string",
         "keyType": "string",
         "region": "string",
         "resourceId": "string",
         "roleArn": "string",
         "secretArn": "string",
         "url": "string"
      },
      "description": "string",
      "entitlementArn": "string",
      "gatewayBridgeSource": { 
         "bridgeArn": "string",
         "vpcInterfaceAttachment": { 
            "vpcInterfaceName": "string"
         }
      },
      "ingestIp": "string",
      "ingestPort": number,
      "mediaStreamSourceConfigurations": [ 
         { 
            "encodingName": "string",
            "inputConfigurations": [ 
               { 
                  "inputIp": "string",
                  "inputPort": number,
                  "interface": { 
                     "name": "string"
                  }
               }
            ],
            "mediaStreamName": "string"
         }
      ],
      "name": "string",
      "peerIpAddress": "string",
      "routerIntegrationState": "string",
      "routerIntegrationTransitDecryption": { 
         "encryptionKeyConfiguration": { ... },
         "encryptionKeyType": "string"
      },
      "senderControlPort": number,
      "senderIpAddress": "string",
      "sourceArn": "string",
      "transport": { 
         "cidrAllowList": [ "string" ],
         "maxBitrate": number,
         "maxLatency": number,
         "maxSyncBuffer": number,
         "minLatency": number,
         "ndiProgramName": "string",
         "ndiSourceSettings": { 
            "sourceName": "string"
         },
         "ndiSpeedHqQuality": number,
         "protocol": "string",
         "remoteId": "string",
         "senderControlPort": number,
         "senderIpAddress": "string",
         "smoothingLatency": number,
         "sourceListenerAddress": "string",
         "sourceListenerPort": number,
         "streamId": "string"
      },
      "vpcInterfaceName": "string",
      "whitelistCidr": "string"
   }
}
```

## Response Elements
<a name="API_UpdateFlowSource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [flowArn](#API_UpdateFlowSource_ResponseSyntax) **   <a name="mediaconnect-UpdateFlowSource-response-flowArn"></a>
The ARN of the flow that you updated.  
Type: String

 ** [source](#API_UpdateFlowSource_ResponseSyntax) **   <a name="mediaconnect-UpdateFlowSource-response-source"></a>
The details of the sources that are assigned to the flow.   
Type: [Source](API_Source.md) object

## Errors
<a name="API_UpdateFlowSource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_UpdateFlowSource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UpdateFlowSource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UpdateFlowSource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UpdateFlowSource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UpdateFlowSource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UpdateFlowSource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UpdateFlowSource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UpdateFlowSource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UpdateFlowSource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UpdateFlowSource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UpdateFlowSource) 

# UpdateGatewayInstance
<a name="API_UpdateGatewayInstance"></a>

Updates an existing gateway instance. 

## Request Syntax
<a name="API_UpdateGatewayInstance_RequestSyntax"></a>

```
PUT /v1/gateway-instances/gatewayInstanceArn HTTP/1.1
Content-type: application/json

{
   "bridgePlacement": "string"
}
```

## URI Request Parameters
<a name="API_UpdateGatewayInstance_RequestParameters"></a>

The request uses the following URI parameters.

 ** [gatewayInstanceArn](#API_UpdateGatewayInstance_RequestSyntax) **   <a name="mediaconnect-UpdateGatewayInstance-request-uri-gatewayInstanceArn"></a>
The Amazon Resource Name (ARN) of the gateway instance that you want to update.   
Pattern: `arn:.+:mediaconnect.+:gateway:.+:instance:.+`   
Required: Yes

## Request Body
<a name="API_UpdateGatewayInstance_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [bridgePlacement](#API_UpdateGatewayInstance_RequestSyntax) **   <a name="mediaconnect-UpdateGatewayInstance-request-bridgePlacement"></a>
The state of the instance. `ACTIVE` or `INACTIVE`.   
Type: String  
Valid Values: `AVAILABLE | LOCKED`   
Required: No

## Response Syntax
<a name="API_UpdateGatewayInstance_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "bridgePlacement": "string",
   "gatewayInstanceArn": "string"
}
```

## Response Elements
<a name="API_UpdateGatewayInstance_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [bridgePlacement](#API_UpdateGatewayInstance_ResponseSyntax) **   <a name="mediaconnect-UpdateGatewayInstance-response-bridgePlacement"></a>
The state of the instance. `ACTIVE` or `INACTIVE`.   
Type: String  
Valid Values: `AVAILABLE | LOCKED` 

 ** [gatewayInstanceArn](#API_UpdateGatewayInstance_ResponseSyntax) **   <a name="mediaconnect-UpdateGatewayInstance-response-gatewayInstanceArn"></a>
The ARN of the instance that was updated.   
Type: String

## Errors
<a name="API_UpdateGatewayInstance_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_UpdateGatewayInstance_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UpdateGatewayInstance) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UpdateGatewayInstance) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UpdateGatewayInstance) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UpdateGatewayInstance) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UpdateGatewayInstance) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UpdateGatewayInstance) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UpdateGatewayInstance) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UpdateGatewayInstance) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UpdateGatewayInstance) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UpdateGatewayInstance) 

# UpdateRouterInput
<a name="API_UpdateRouterInput"></a>

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

## Request Syntax
<a name="API_UpdateRouterInput_RequestSyntax"></a>

```
PUT /v1/routerInput/arn HTTP/1.1
Content-type: application/json

{
   "configuration": { ... },
   "maintenanceConfiguration": { ... },
   "maximumBitrate": number,
   "name": "string",
   "routingScope": "string",
   "tier": "string",
   "transitEncryption": { 
      "encryptionKeyConfiguration": { ... },
      "encryptionKeyType": "string"
   }
}
```

## URI Request Parameters
<a name="API_UpdateRouterInput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_UpdateRouterInput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterInput-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router input that you want to update.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerInput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_UpdateRouterInput_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [configuration](#API_UpdateRouterInput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterInput-request-configuration"></a>
The updated configuration settings for the router input. Changing the type of the configuration is not supported.  
Type: [RouterInputConfiguration](API_RouterInputConfiguration.md) object  
 **Note: **This object is a Union. Only one member of this object can be specified or returned.  
Required: No

 ** [maintenanceConfiguration](#API_UpdateRouterInput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterInput-request-maintenanceConfiguration"></a>
The updated maintenance configuration settings for the router input, including any changes to preferred maintenance windows and schedules.  
Type: [MaintenanceConfiguration](API_MaintenanceConfiguration.md) object  
 **Note: **This object is a Union. Only one member of this object can be specified or returned.  
Required: No

 ** [maximumBitrate](#API_UpdateRouterInput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterInput-request-maximumBitrate"></a>
The updated maximum bitrate for the router input.  
Type: Long  
Required: No

 ** [name](#API_UpdateRouterInput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterInput-request-name"></a>
The updated name for the router input.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Required: No

 ** [routingScope](#API_UpdateRouterInput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterInput-request-routingScope"></a>
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: String  
Valid Values: `REGIONAL | GLOBAL`   
Required: No

 ** [tier](#API_UpdateRouterInput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterInput-request-tier"></a>
The updated tier level for the router input.  
Type: String  
Valid Values: `INPUT_100 | INPUT_50 | INPUT_20`   
Required: No

 ** [transitEncryption](#API_UpdateRouterInput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterInput-request-transitEncryption"></a>
The updated transit encryption settings for the router input.  
Type: [RouterInputTransitEncryption](API_RouterInputTransitEncryption.md) object  
Required: No

## Response Syntax
<a name="API_UpdateRouterInput_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "routerInput": { 
      "arn": "string",
      "availabilityZone": "string",
      "configuration": { ... },
      "createdAt": "string",
      "id": "string",
      "inputType": "string",
      "ipAddress": "string",
      "maintenanceConfiguration": { ... },
      "maintenanceSchedule": { ... },
      "maintenanceScheduleType": "string",
      "maintenanceType": "string",
      "maximumBitrate": number,
      "maximumRoutedOutputs": number,
      "messages": [ 
         { 
            "code": "string",
            "message": "string"
         }
      ],
      "name": "string",
      "regionName": "string",
      "routedOutputs": number,
      "routingScope": "string",
      "state": "string",
      "streamDetails": { ... },
      "tags": { 
         "string" : "string" 
      },
      "tier": "string",
      "transitEncryption": { 
         "encryptionKeyConfiguration": { ... },
         "encryptionKeyType": "string"
      },
      "updatedAt": "string"
   }
}
```

## Response Elements
<a name="API_UpdateRouterInput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [routerInput](#API_UpdateRouterInput_ResponseSyntax) **   <a name="mediaconnect-UpdateRouterInput-response-routerInput"></a>
The updated router input.  
Type: [RouterInput](API_RouterInput.md) object

## Errors
<a name="API_UpdateRouterInput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_UpdateRouterInput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UpdateRouterInput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UpdateRouterInput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UpdateRouterInput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UpdateRouterInput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UpdateRouterInput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UpdateRouterInput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UpdateRouterInput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UpdateRouterInput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UpdateRouterInput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UpdateRouterInput) 

# UpdateRouterNetworkInterface
<a name="API_UpdateRouterNetworkInterface"></a>

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

## Request Syntax
<a name="API_UpdateRouterNetworkInterface_RequestSyntax"></a>

```
PUT /v1/routerNetworkInterface/arn HTTP/1.1
Content-type: application/json

{
   "configuration": { ... },
   "name": "string"
}
```

## URI Request Parameters
<a name="API_UpdateRouterNetworkInterface_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_UpdateRouterNetworkInterface_RequestSyntax) **   <a name="mediaconnect-UpdateRouterNetworkInterface-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router network interface that you want to update.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerNetworkInterface:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_UpdateRouterNetworkInterface_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [configuration](#API_UpdateRouterNetworkInterface_RequestSyntax) **   <a name="mediaconnect-UpdateRouterNetworkInterface-request-configuration"></a>
The updated configuration settings for the router network interface. Changing the type of the configuration is not supported.  
Type: [RouterNetworkInterfaceConfiguration](API_RouterNetworkInterfaceConfiguration.md) object  
 **Note: **This object is a Union. Only one member of this object can be specified or returned.  
Required: No

 ** [name](#API_UpdateRouterNetworkInterface_RequestSyntax) **   <a name="mediaconnect-UpdateRouterNetworkInterface-request-name"></a>
The updated name for the router network interface.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Required: No

## Response Syntax
<a name="API_UpdateRouterNetworkInterface_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "routerNetworkInterface": { 
      "arn": "string",
      "associatedInputCount": number,
      "associatedOutputCount": number,
      "configuration": { ... },
      "createdAt": "string",
      "id": "string",
      "name": "string",
      "networkInterfaceType": "string",
      "regionName": "string",
      "state": "string",
      "tags": { 
         "string" : "string" 
      },
      "updatedAt": "string"
   }
}
```

## Response Elements
<a name="API_UpdateRouterNetworkInterface_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [routerNetworkInterface](#API_UpdateRouterNetworkInterface_ResponseSyntax) **   <a name="mediaconnect-UpdateRouterNetworkInterface-response-routerNetworkInterface"></a>
The updated router network interface.  
Type: [RouterNetworkInterface](API_RouterNetworkInterface.md) object

## Errors
<a name="API_UpdateRouterNetworkInterface_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_UpdateRouterNetworkInterface_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UpdateRouterNetworkInterface) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UpdateRouterNetworkInterface) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UpdateRouterNetworkInterface) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UpdateRouterNetworkInterface) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UpdateRouterNetworkInterface) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UpdateRouterNetworkInterface) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UpdateRouterNetworkInterface) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UpdateRouterNetworkInterface) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UpdateRouterNetworkInterface) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UpdateRouterNetworkInterface) 

# UpdateRouterOutput
<a name="API_UpdateRouterOutput"></a>

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

## Request Syntax
<a name="API_UpdateRouterOutput_RequestSyntax"></a>

```
PUT /v1/routerOutput/arn HTTP/1.1
Content-type: application/json

{
   "configuration": { ... },
   "maintenanceConfiguration": { ... },
   "maximumBitrate": number,
   "name": "string",
   "routingScope": "string",
   "tier": "string"
}
```

## URI Request Parameters
<a name="API_UpdateRouterOutput_RequestParameters"></a>

The request uses the following URI parameters.

 ** [arn](#API_UpdateRouterOutput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterOutput-request-uri-arn"></a>
The Amazon Resource Name (ARN) of the router output that you want to update.  
Pattern: `arn:(aws[a-zA-Z-]*):mediaconnect:[a-z0-9-]+:[0-9]{12}:routerOutput:[a-z0-9]{12}`   
Required: Yes

## Request Body
<a name="API_UpdateRouterOutput_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [configuration](#API_UpdateRouterOutput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterOutput-request-configuration"></a>
The updated configuration settings for the router output. Changing the type of the configuration is not supported.  
Type: [RouterOutputConfiguration](API_RouterOutputConfiguration.md) object  
 **Note: **This object is a Union. Only one member of this object can be specified or returned.  
Required: No

 ** [maintenanceConfiguration](#API_UpdateRouterOutput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterOutput-request-maintenanceConfiguration"></a>
The updated maintenance configuration settings for the router output, including any changes to preferred maintenance windows and schedules.  
Type: [MaintenanceConfiguration](API_MaintenanceConfiguration.md) object  
 **Note: **This object is a Union. Only one member of this object can be specified or returned.  
Required: No

 ** [maximumBitrate](#API_UpdateRouterOutput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterOutput-request-maximumBitrate"></a>
The updated maximum bitrate for the router output.  
Type: Long  
Required: No

 ** [name](#API_UpdateRouterOutput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterOutput-request-name"></a>
The updated name for the router output.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Required: No

 ** [routingScope](#API_UpdateRouterOutput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterOutput-request-routingScope"></a>
Specifies whether the router output can take inputs that are in different Regions. REGIONAL (default) - can only take inputs from same Region. GLOBAL - can take inputs from any Region.  
Type: String  
Valid Values: `REGIONAL | GLOBAL`   
Required: No

 ** [tier](#API_UpdateRouterOutput_RequestSyntax) **   <a name="mediaconnect-UpdateRouterOutput-request-tier"></a>
The updated tier level for the router output.  
Type: String  
Valid Values: `OUTPUT_100 | OUTPUT_50 | OUTPUT_20`   
Required: No

## Response Syntax
<a name="API_UpdateRouterOutput_ResponseSyntax"></a>

```
HTTP/1.1 202
Content-type: application/json

{
   "routerOutput": { 
      "arn": "string",
      "availabilityZone": "string",
      "configuration": { ... },
      "createdAt": "string",
      "id": "string",
      "ipAddress": "string",
      "maintenanceConfiguration": { ... },
      "maintenanceSchedule": { ... },
      "maintenanceScheduleType": "string",
      "maintenanceType": "string",
      "maximumBitrate": number,
      "messages": [ 
         { 
            "code": "string",
            "message": "string"
         }
      ],
      "name": "string",
      "outputType": "string",
      "regionName": "string",
      "routedInputArn": "string",
      "routedState": "string",
      "routingScope": "string",
      "state": "string",
      "streamDetails": { ... },
      "tags": { 
         "string" : "string" 
      },
      "tier": "string",
      "updatedAt": "string"
   }
}
```

## Response Elements
<a name="API_UpdateRouterOutput_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 202 response.

The following data is returned in JSON format by the service.

 ** [routerOutput](#API_UpdateRouterOutput_ResponseSyntax) **   <a name="mediaconnect-UpdateRouterOutput-response-routerOutput"></a>
The updated router output.  
Type: [RouterOutput](API_RouterOutput.md) object

## Errors
<a name="API_UpdateRouterOutput_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** BadRequestException **   
This exception is thrown if the request contains a semantic error. The precise meaning depends on the API, and is documented in the error message.   
HTTP Status Code: 400

 ** ConflictException **   
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.   
HTTP Status Code: 409

 ** ForbiddenException **   
You do not have sufficient access to perform this action.   
HTTP Status Code: 403

 ** InternalServerErrorException **   
The server encountered an internal error and is unable to complete the request.   
HTTP Status Code: 500

 ** NotFoundException **   
One or more of the resources in the request does not exist in the system.   
HTTP Status Code: 404

 ** ServiceUnavailableException **   
The service is currently unavailable or busy.   
HTTP Status Code: 503

 ** TooManyRequestsException **   
The request was denied due to request throttling.   
HTTP Status Code: 429

## See Also
<a name="API_UpdateRouterOutput_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/mediaconnect-2018-11-14/UpdateRouterOutput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/mediaconnect-2018-11-14/UpdateRouterOutput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/mediaconnect-2018-11-14/UpdateRouterOutput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/mediaconnect-2018-11-14/UpdateRouterOutput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/mediaconnect-2018-11-14/UpdateRouterOutput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/mediaconnect-2018-11-14/UpdateRouterOutput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/mediaconnect-2018-11-14/UpdateRouterOutput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/mediaconnect-2018-11-14/UpdateRouterOutput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/mediaconnect-2018-11-14/UpdateRouterOutput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/mediaconnect-2018-11-14/UpdateRouterOutput)