VPC interfaces: remove - AWS Elemental MediaConnect

VPC interfaces: remove

URI

/v1/flows/flowArn/vpcInterfaces/vpcInterfaceName

HTTP methods

DELETE

Operation ID: RemoveFlowVpcInterface

Removes a VPC interface from a flow. You can only remove a VPC interface if it isn't doesn't have a source or output associated with it.

Path parameters
NameTypeRequiredDescription
flowArnStringTrue

The Amazon Resource Name (ARN) of the flow.

vpcInterfaceNameStringTrue

The name of the VPC interface that you want to remove.

Responses
Status codeResponse modelDescription
200RemoveFlowVpcInterfaceResponse

The VPC interface was successfully removed from the flow.

400ResponseError

The request that you submitted is not valid.

403ResponseError

You don't have the required permissions to perform this operation.

404ResponseError

MediaConnect did not find the resource that you specified in the request.

429ResponseError

You have exceeded the service request rate limit for your MediaConnect account.

500ResponseError

MediaConnect can't fulfill your request because it encountered an unexpected condition.

503ResponseError

MediaConnect is currently unavailable. Try again later.

Schemas

Response bodies

{ "flowArn": "string", "vpcInterfaceName": "string", "nonDeletedNetworkInterfaceIds": [ "string" ] }
{ "message": "string" }

Properties

RemoveFlowVpcInterfaceResponse

The result of a successful RemoveFlowVpcInterface request including the flow ARN and the name of the VPC interface that was removed.

PropertyTypeRequiredDescription
flowArn

string

True

The ARN of the flow that is associated with the VPC interface that you removed.

nonDeletedNetworkInterfaceIds

Array of type string

False

The IDs of network interfaces that MediaConnect was unable to remove when you removed your VPC interface. The result is that your VPC interface is removed from MediaConnect, but the network interfaces are still associated with your VPC. You should delete the network interfaces in your VPC.

vpcInterfaceName

string

True

The name of the VPC interface that you removed.

ResponseError

An exception raised by MediaConnect when you submit a request that cannot be completed. For more information, see the error message and documentation for the operation.

PropertyTypeRequiredDescription
message

string

True

The specific error message that MediaConnect returns to help you understand the reason that the request did not succeed.

See also

For more information about using this API in one of the language-specific AWS SDKs and references, see the following:

RemoveFlowVpcInterface