AWS::EC2::ClientVpnRoute - AWS CloudFormation
SyntaxPropertiesExamplesSee also

AWS::EC2::ClientVpnRoute

Specifies a network route to add to a Client VPN endpoint. Each Client VPN endpoint has a route table that describes the available destination network routes. Each route in the route table specifies the path for traffic to specific resources or networks.

A target network association must be created before you can specify a route. If you're setting up all the components of a Client VPN endpoint at the same time, you must use the DependsOn Attribute to declare a dependency on the AWS::EC2::ClientVpnTargetNetworkAssociation resource.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::EC2::ClientVpnRoute",
  "Properties" : {
      "ClientVpnEndpointId" : String,
      "Description" : String,
      "DestinationCidrBlock" : String,
      "TargetVpcSubnetId" : String
    }
}

YAML

Type: AWS::EC2::ClientVpnRoute
Properties:
  ClientVpnEndpointId: String
  Description: String
  DestinationCidrBlock: String
  TargetVpcSubnetId: String

Properties

ClientVpnEndpointId

The ID of the Client VPN endpoint to which to add the route.

Required: Yes

Type: String

Update requires: Replacement

Description

A brief description of the route.

Required: No

Type: String

Update requires: Replacement

DestinationCidrBlock

The IPv4 address range, in CIDR notation, of the route destination. For example:

  • To add a route for Internet access, enter 0.0.0.0/0

  • To add a route for a peered VPC, enter the peered VPC's IPv4 CIDR range

  • To add a route for an on-premises network, enter the AWS Site-to-Site VPN connection's IPv4 CIDR range

  • To add a route for the local network, enter the client CIDR range

Required: Yes

Type: String

Update requires: Replacement

TargetVpcSubnetId

The ID of the subnet through which you want to route traffic. The specified subnet must be an existing target network of the Client VPN endpoint.

Alternatively, if you're adding a route for the local network, specify local.

Required: Yes

Type: String

Update requires: Replacement

Examples

Add a route to a client VPN endpoint

The following example adds a route for internet access to a client VPN endpoint.

YAML

myRoute:
  Type: "AWS::EC2::ClientVpnRoute"
  Properties:
    ClientVpnEndpointId: 
      Ref: myClientVpnEndpoint
    TargetVpcSubnetId: 
      Ref: mySubnet
    DestinationCidrBlock: "0.0.0.0/0"
    Description: "myRoute"

JSON

"myRoute": {
    "Type": "AWS::EC2::ClientVpnRoute",
    "Properties": {
        "ClientVpnEndpointId": {
            "Ref": "myClientVpnEndpoint"
        },
        "TargetVpcSubnetId": {
            "Ref": "mySubnet"
        },
        "DestinationCidrBlock": "0.0.0.0/0",
        "Description": "myRoute"
    }
}

See also