This is the new AWS CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS CloudFormation User Guide.
AWS::EC2::VPNConnection VpnTunnelOptionsSpecification
The tunnel options for a single VPN tunnel.
Syntax
To declare this entity in your AWS CloudFormation template, use the following syntax:
JSON
{ "DPDTimeoutAction" :String, "DPDTimeoutSeconds" :Integer, "EnableTunnelLifecycleControl" :Boolean, "IKEVersions" :[ IKEVersionsRequestListValue, ... ], "LogOptions" :VpnTunnelLogOptionsSpecification, "Phase1DHGroupNumbers" :[ Phase1DHGroupNumbersRequestListValue, ... ], "Phase1EncryptionAlgorithms" :[ Phase1EncryptionAlgorithmsRequestListValue, ... ], "Phase1IntegrityAlgorithms" :[ Phase1IntegrityAlgorithmsRequestListValue, ... ], "Phase1LifetimeSeconds" :Integer, "Phase2DHGroupNumbers" :[ Phase2DHGroupNumbersRequestListValue, ... ], "Phase2EncryptionAlgorithms" :[ Phase2EncryptionAlgorithmsRequestListValue, ... ], "Phase2IntegrityAlgorithms" :[ Phase2IntegrityAlgorithmsRequestListValue, ... ], "Phase2LifetimeSeconds" :Integer, "PreSharedKey" :String, "RekeyFuzzPercentage" :Integer, "RekeyMarginTimeSeconds" :Integer, "ReplayWindowSize" :Integer, "StartupAction" :String, "TunnelInsideCidr" :String, "TunnelInsideIpv6Cidr" :String}
YAML
DPDTimeoutAction:StringDPDTimeoutSeconds:IntegerEnableTunnelLifecycleControl:BooleanIKEVersions:- IKEVersionsRequestListValueLogOptions:VpnTunnelLogOptionsSpecificationPhase1DHGroupNumbers:- Phase1DHGroupNumbersRequestListValuePhase1EncryptionAlgorithms:- Phase1EncryptionAlgorithmsRequestListValuePhase1IntegrityAlgorithms:- Phase1IntegrityAlgorithmsRequestListValuePhase1LifetimeSeconds:IntegerPhase2DHGroupNumbers:- Phase2DHGroupNumbersRequestListValuePhase2EncryptionAlgorithms:- Phase2EncryptionAlgorithmsRequestListValuePhase2IntegrityAlgorithms:- Phase2IntegrityAlgorithmsRequestListValuePhase2LifetimeSeconds:IntegerPreSharedKey:StringRekeyFuzzPercentage:IntegerRekeyMarginTimeSeconds:IntegerReplayWindowSize:IntegerStartupAction:StringTunnelInsideCidr:StringTunnelInsideIpv6Cidr:String
Properties
- DPDTimeoutAction
- 
                    The action to take after DPD timeout occurs. Specify restartto restart the IKE initiation. Specifyclearto end the IKE session.Valid Values: clear|none|restartDefault: clearRequired: No Type: String Allowed values: clear | none | restartUpdate requires: Replacement 
- DPDTimeoutSeconds
- 
                    The number of seconds after which a DPD timeout occurs. Constraints: A value greater than or equal to 30. Default: 30Required: No Type: Integer Minimum: 30Update requires: Replacement 
- EnableTunnelLifecycleControl
- 
                    Turn on or off tunnel endpoint lifecycle control feature. Required: No Type: Boolean Update requires: Replacement 
- IKEVersions
- 
                    The IKE versions that are permitted for the VPN tunnel. Valid values: ikev1|ikev2Required: No Type: Array of IKEVersionsRequestListValue Update requires: Replacement 
- LogOptions
- 
                    Options for logging VPN tunnel activity. Required: No Type: VpnTunnelLogOptionsSpecification Update requires: Replacement 
- Phase1DHGroupNumbers
- 
                    One or more Diffie-Hellman group numbers that are permitted for the VPN tunnel for phase 1 IKE negotiations. Valid values: 2|14|15|16|17|18|19|20|21|22|23|24Required: No Type: Array of Phase1DHGroupNumbersRequestListValue Update requires: Replacement 
- Phase1EncryptionAlgorithms
- 
                    One or more encryption algorithms that are permitted for the VPN tunnel for phase 1 IKE negotiations. Valid values: AES128|AES256|AES128-GCM-16|AES256-GCM-16Required: No Type: Array of Phase1EncryptionAlgorithmsRequestListValue Update requires: Replacement 
- Phase1IntegrityAlgorithms
- 
                    One or more integrity algorithms that are permitted for the VPN tunnel for phase 1 IKE negotiations. Valid values: SHA1|SHA2-256|SHA2-384|SHA2-512Required: No Type: Array of Phase1IntegrityAlgorithmsRequestListValue Update requires: Replacement 
- Phase1LifetimeSeconds
- 
                    The lifetime for phase 1 of the IKE negotiation, in seconds. Constraints: A value between 900 and 28,800. Default: 28800Required: No Type: Integer Minimum: 900Maximum: 28800Update requires: Replacement 
- Phase2DHGroupNumbers
- 
                    One or more Diffie-Hellman group numbers that are permitted for the VPN tunnel for phase 2 IKE negotiations. Valid values: 2|5|14|15|16|17|18|19|20|21|22|23|24Required: No Type: Array of Phase2DHGroupNumbersRequestListValue Update requires: Replacement 
- Phase2EncryptionAlgorithms
- 
                    One or more encryption algorithms that are permitted for the VPN tunnel for phase 2 IKE negotiations. Valid values: AES128|AES256|AES128-GCM-16|AES256-GCM-16Required: No Type: Array of Phase2EncryptionAlgorithmsRequestListValue Update requires: Replacement 
- Phase2IntegrityAlgorithms
- 
                    One or more integrity algorithms that are permitted for the VPN tunnel for phase 2 IKE negotiations. Valid values: SHA1|SHA2-256|SHA2-384|SHA2-512Required: No Type: Array of Phase2IntegrityAlgorithmsRequestListValue Update requires: Replacement 
- Phase2LifetimeSeconds
- 
                    The lifetime for phase 2 of the IKE negotiation, in seconds. Constraints: A value between 900 and 3,600. The value must be less than the value for Phase1LifetimeSeconds.Default: 3600Required: No Type: Integer Minimum: 900Maximum: 3600Update requires: Replacement 
- 
                    The pre-shared key (PSK) to establish initial authentication between the virtual private gateway and customer gateway. Constraints: Allowed characters are alphanumeric characters, periods (.), and underscores (_). Must be between 8 and 64 characters in length and cannot start with zero (0). Required: No Type: String Update requires: Replacement 
- RekeyFuzzPercentage
- 
                    The percentage of the rekey window (determined by RekeyMarginTimeSeconds) during which the rekey time is randomly selected.Constraints: A value between 0 and 100. Default: 100Required: No Type: Integer Minimum: 0Maximum: 100Update requires: Replacement 
- RekeyMarginTimeSeconds
- 
                    The margin time, in seconds, before the phase 2 lifetime expires, during which the AWS side of the VPN connection performs an IKE rekey. The exact time of the rekey is randomly selected based on the value for RekeyFuzzPercentage.Constraints: A value between 60 and half of Phase2LifetimeSeconds.Default: 270Required: No Type: Integer Minimum: 60Update requires: Replacement 
- ReplayWindowSize
- 
                    The number of packets in an IKE replay window. Constraints: A value between 64 and 2048. Default: 1024Required: No Type: Integer Minimum: 64Maximum: 2048Update requires: Replacement 
- StartupAction
- 
                    The action to take when the establishing the tunnel for the VPN connection. By default, your customer gateway device must initiate the IKE negotiation and bring up the tunnel. Specify startfor AWS to initiate the IKE negotiation.Valid Values: add|startDefault: addRequired: No Type: String Allowed values: add | startUpdate requires: Replacement 
- TunnelInsideCidr
- 
                    The range of inside IP addresses for the tunnel. Any specified CIDR blocks must be unique across all VPN connections that use the same virtual private gateway. Constraints: A size /30 CIDR block from the 169.254.0.0/16range. The following CIDR blocks are reserved and cannot be used:- 
                            169.254.0.0/30
- 
                            169.254.1.0/30
- 
                            169.254.2.0/30
- 
                            169.254.3.0/30
- 
                            169.254.4.0/30
- 
                            169.254.5.0/30
- 
                            169.254.169.252/30
 Required: No Type: String Update requires: Replacement 
- 
                            
- TunnelInsideIpv6Cidr
- 
                    The range of inside IPv6 addresses for the tunnel. Any specified CIDR blocks must be unique across all VPN connections that use the same transit gateway. Constraints: A size /126 CIDR block from the local fd00::/8range.Required: No Type: String Update requires: Replacement