Skip to content

/AWS1/CL_EC2=>CREATEVPNCONNECTION()

About CreateVpnConnection

Creates a VPN connection between an existing virtual private gateway or transit gateway and a customer gateway. The supported connection type is ipsec.1.

The response includes information that you need to give to your network administrator to configure your customer gateway.

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

If you decide to shut down your VPN connection for any reason and later create a new VPN connection, you must reconfigure your customer gateway with the new information returned from this call.

This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn't return an error.

For more information, see Amazon Web Services Site-to-Site VPN in the Amazon Web Services Site-to-Site VPN User Guide.

Method Signature

IMPORTING

Required arguments:

IV_CUSTOMERGATEWAYID TYPE /AWS1/EC2CUSTOMERGATEWAYID /AWS1/EC2CUSTOMERGATEWAYID

The ID of the customer gateway.

IV_TYPE TYPE /AWS1/EC2STRING /AWS1/EC2STRING

The type of VPN connection (ipsec.1).

Optional arguments:

IV_VPNGATEWAYID TYPE /AWS1/EC2VPNGATEWAYID /AWS1/EC2VPNGATEWAYID

The ID of the virtual private gateway. If you specify a virtual private gateway, you cannot specify a transit gateway.

IV_TRANSITGATEWAYID TYPE /AWS1/EC2TRANSITGATEWAYID /AWS1/EC2TRANSITGATEWAYID

The ID of the transit gateway. If you specify a transit gateway, you cannot specify a virtual private gateway.

IT_TAGSPECIFICATIONS TYPE /AWS1/CL_EC2TAGSPECIFICATION=>TT_TAGSPECIFICATIONLIST TT_TAGSPECIFICATIONLIST

The tags to apply to the VPN connection.

IV_DRYRUN TYPE /AWS1/EC2BOOLEAN /AWS1/EC2BOOLEAN

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

IO_OPTIONS TYPE REF TO /AWS1/CL_EC2VPNCONNOPTIONSSPEC /AWS1/CL_EC2VPNCONNOPTIONSSPEC

The options for the VPN connection.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_EC2CREATEVPNCONNRSLT /AWS1/CL_EC2CREATEVPNCONNRSLT