VpnTunnelOptionsSpecification
The tunnel options for a single VPN tunnel.
Contents
- 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:
clearType: String
Required: No
- DPDTimeoutSeconds
-
The number of seconds after which a DPD timeout occurs.
Constraints: A value greater than or equal to 30.
Default:
30Type: Integer
Required: No
- EnableTunnelLifecycleControl
-
Turn on or off tunnel endpoint lifecycle control feature.
Type: Boolean
Required: No
- IKEVersions
-
The IKE versions that are permitted for the VPN tunnel.
Valid values:
ikev1|ikev2Type: Array of IKEVersionsRequestListValue objects
Required: No
- LogOptions
-
Options for logging VPN tunnel activity.
Type: VpnTunnelLogOptionsSpecification object
Required: No
- 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|24Type: Array of Phase1DHGroupNumbersRequestListValue objects
Required: No
- 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-16Type: Array of Phase1EncryptionAlgorithmsRequestListValue objects
Required: No
- 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-512Type: Array of Phase1IntegrityAlgorithmsRequestListValue objects
Required: No
- Phase1LifetimeSeconds
-
The lifetime for phase 1 of the IKE negotiation, in seconds.
Constraints: A value between 900 and 28,800.
Default:
28800Type: Integer
Required: No
- 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|24Type: Array of Phase2DHGroupNumbersRequestListValue objects
Required: No
- 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-16Type: Array of Phase2EncryptionAlgorithmsRequestListValue objects
Required: No
- 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-512Type: Array of Phase2IntegrityAlgorithmsRequestListValue objects
Required: No
- 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:
3600Type: Integer
Required: No
- PreSharedKey
-
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).
Type: String
Required: No
- 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:
100Type: Integer
Required: No
- 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:
270Type: Integer
Required: No
- ReplayWindowSize
-
The number of packets in an IKE replay window.
Constraints: A value between 64 and 2048.
Default:
1024Type: Integer
Required: No
- 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:
addType: String
Required: No
- TunnelInsideCidr
-
The range of inside IPv4 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
Type: String
Required: No
-
- 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.Type: String
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: