Amazon Elastic Compute Cloud
API Reference (API Version 2013-02-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

CreateVpnConnectionRoute

Description

Creates a new static route associated with a VPN connection between an existing virtual private gateway and a VPN customer gateway. The static route allows traffic to be routed from the virtual private gateway to the VPN customer gateway.

Important

We strongly recommend you use HTTPS when calling this operation because the response contains sensitive cryptographic information for configuring your customer gateway.

For more information about VPN connections, see Adding an IPsec Hardware Virtual Private Gateway to Your VPC in the Amazon Virtual Private Cloud User Guide.

Request Parameters

DestinationCidrBlock

The CIDR block associated with the local subnet of the customer network.

Type: String

Default: None

Required: Yes

VpnConnectionId

The ID of the VPN connection.

Type: String

Default: None

Required: Yes

Response Elements

The following elements are returned in an CreateVpnConnectionRouteResponse element.

requestId

The ID of the request.

Type: xsd:string

return

Returns true if the request succeeds. Otherwise, returns an error.

Type: xsd:boolean

Examples

Example Request

This example creates a static route to the VPN connection for the VPN connection ID vpn-83ad48ea to the destination CIDR block 11.12.0.0/16. Note that when using the Query API the "/" is denoted as "%2F".

https://ec2.amazonaws.com/?Action=CreateVpnConnectionRoute
&DestinationCidrBlock=11.12.0.0%2F16
&VpnConnectionId=vpn-83ad48ea
&AUTHPARAMS

Example Response

<CreateVpnConnectionRouteResponse xmlns="http://ec2.amazonaws.com/doc/2013-02-01/">
    <requestId>4f35a1b2-c2c3-4093-b51f-abb9d7311990</requestId>
    <return>true</return>
</CreateVpnConnectionRouteResponse>