CfnVPNConnectionPropsMixin

class aws_cdk.mixins_preview.aws_ec2.mixins.CfnVPNConnectionPropsMixin(props, *, strategy=None)

Bases: Mixin

Specifies a VPN connection between a virtual private gateway and a VPN customer gateway or a transit gateway and a VPN customer gateway.

To specify a VPN connection between a transit gateway and customer gateway, use the TransitGatewayId and CustomerGatewayId properties.

To specify a VPN connection between a virtual private gateway and customer gateway, use the VpnGatewayId and CustomerGatewayId properties.

For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide .

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-vpnconnection.html

CloudformationResource:

AWS::EC2::VPNConnection

Mixin:

true

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview import mixins
from aws_cdk.mixins_preview.aws_ec2 import mixins as ec2_mixins

cfn_vPNConnection_props_mixin = ec2_mixins.CfnVPNConnectionPropsMixin(ec2_mixins.CfnVPNConnectionMixinProps(
    customer_gateway_id="customerGatewayId",
    enable_acceleration=False,
    local_ipv4_network_cidr="localIpv4NetworkCidr",
    local_ipv6_network_cidr="localIpv6NetworkCidr",
    outside_ip_address_type="outsideIpAddressType",
    pre_shared_key_storage="preSharedKeyStorage",
    remote_ipv4_network_cidr="remoteIpv4NetworkCidr",
    remote_ipv6_network_cidr="remoteIpv6NetworkCidr",
    static_routes_only=False,
    tags=[CfnTag(
        key="key",
        value="value"
    )],
    transit_gateway_id="transitGatewayId",
    transport_transit_gateway_attachment_id="transportTransitGatewayAttachmentId",
    tunnel_bandwidth="tunnelBandwidth",
    tunnel_inside_ip_version="tunnelInsideIpVersion",
    type="type",
    vpn_concentrator_id="vpnConcentratorId",
    vpn_gateway_id="vpnGatewayId",
    vpn_tunnel_options_specifications=[ec2_mixins.CfnVPNConnectionPropsMixin.VpnTunnelOptionsSpecificationProperty(
        dpd_timeout_action="dpdTimeoutAction",
        dpd_timeout_seconds=123,
        enable_tunnel_lifecycle_control=False,
        ike_versions=[{
            "value": "value"
        }],
        log_options=ec2_mixins.CfnVPNConnectionPropsMixin.VpnTunnelLogOptionsSpecificationProperty(
            cloudwatch_log_options=ec2_mixins.CfnVPNConnectionPropsMixin.CloudwatchLogOptionsSpecificationProperty(
                bgp_log_enabled=False,
                bgp_log_group_arn="bgpLogGroupArn",
                bgp_log_output_format="bgpLogOutputFormat",
                log_enabled=False,
                log_group_arn="logGroupArn",
                log_output_format="logOutputFormat"
            )
        ),
        phase1_dh_group_numbers=[ec2_mixins.CfnVPNConnectionPropsMixin.Phase1DHGroupNumbersRequestListValueProperty(
            value=123
        )],
        phase1_encryption_algorithms=[ec2_mixins.CfnVPNConnectionPropsMixin.Phase1EncryptionAlgorithmsRequestListValueProperty(
            value="value"
        )],
        phase1_integrity_algorithms=[ec2_mixins.CfnVPNConnectionPropsMixin.Phase1IntegrityAlgorithmsRequestListValueProperty(
            value="value"
        )],
        phase1_lifetime_seconds=123,
        phase2_dh_group_numbers=[ec2_mixins.CfnVPNConnectionPropsMixin.Phase2DHGroupNumbersRequestListValueProperty(
            value=123
        )],
        phase2_encryption_algorithms=[ec2_mixins.CfnVPNConnectionPropsMixin.Phase2EncryptionAlgorithmsRequestListValueProperty(
            value="value"
        )],
        phase2_integrity_algorithms=[ec2_mixins.CfnVPNConnectionPropsMixin.Phase2IntegrityAlgorithmsRequestListValueProperty(
            value="value"
        )],
        phase2_lifetime_seconds=123,
        pre_shared_key="preSharedKey",
        rekey_fuzz_percentage=123,
        rekey_margin_time_seconds=123,
        replay_window_size=123,
        startup_action="startupAction",
        tunnel_inside_cidr="tunnelInsideCidr",
        tunnel_inside_ipv6_cidr="tunnelInsideIpv6Cidr"
    )]
),
    strategy=mixins.PropertyMergeStrategy.OVERRIDE
)

Create a mixin to apply properties to AWS::EC2::VPNConnection.

Parameters:

Methods

apply_to(construct)

Apply the mixin properties to the construct.

Parameters:

construct (IConstruct)

Return type:

IConstruct

supports(construct)

Check if this mixin supports the given construct.

Parameters:

construct (IConstruct)

Return type:

bool

Attributes

CFN_PROPERTY_KEYS = ['customerGatewayId', 'enableAcceleration', 'localIpv4NetworkCidr', 'localIpv6NetworkCidr', 'outsideIpAddressType', 'preSharedKeyStorage', 'remoteIpv4NetworkCidr', 'remoteIpv6NetworkCidr', 'staticRoutesOnly', 'tags', 'transitGatewayId', 'transportTransitGatewayAttachmentId', 'tunnelBandwidth', 'tunnelInsideIpVersion', 'type', 'vpnConcentratorId', 'vpnGatewayId', 'vpnTunnelOptionsSpecifications']

Static Methods

classmethod is_mixin(x)

(experimental) Checks if x is a Mixin.

Parameters:

x (Any) – Any object.

Return type:

bool

Returns:

true if x is an object created from a class which extends Mixin.

Stability:

experimental

CloudwatchLogOptionsSpecificationProperty

class CfnVPNConnectionPropsMixin.CloudwatchLogOptionsSpecificationProperty(*, bgp_log_enabled=None, bgp_log_group_arn=None, bgp_log_output_format=None, log_enabled=None, log_group_arn=None, log_output_format=None)

Bases: object

Options for sending VPN tunnel logs to CloudWatch.

Parameters:
  • bgp_log_enabled (Union[bool, IResolvable, None]) – Specifies whether to enable BGP logging for the VPN connection. Default value is False . Valid values: True | False

  • bgp_log_group_arn (Optional[str]) – The Amazon Resource Name (ARN) of the CloudWatch log group where BGP logs will be sent.

  • bgp_log_output_format (Optional[str]) – The desired output format for BGP logs to be sent to CloudWatch. Default format is json . Valid values: json | text

  • log_enabled (Union[bool, IResolvable, None]) – Enable or disable VPN tunnel logging feature. Default value is False . Valid values: True | False

  • log_group_arn (Optional[str]) – The Amazon Resource Name (ARN) of the CloudWatch log group to send logs to.

  • log_output_format (Optional[str]) – Set log format. Default format is json . Valid values: json | text

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-cloudwatchlogoptionsspecification.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_ec2 import mixins as ec2_mixins

cloudwatch_log_options_specification_property = ec2_mixins.CfnVPNConnectionPropsMixin.CloudwatchLogOptionsSpecificationProperty(
    bgp_log_enabled=False,
    bgp_log_group_arn="bgpLogGroupArn",
    bgp_log_output_format="bgpLogOutputFormat",
    log_enabled=False,
    log_group_arn="logGroupArn",
    log_output_format="logOutputFormat"
)

Attributes

bgp_log_enabled

Specifies whether to enable BGP logging for the VPN connection. Default value is False .

Valid values: True | False

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-cloudwatchlogoptionsspecification.html#cfn-ec2-vpnconnection-cloudwatchlogoptionsspecification-bgplogenabled

bgp_log_group_arn

The Amazon Resource Name (ARN) of the CloudWatch log group where BGP logs will be sent.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-cloudwatchlogoptionsspecification.html#cfn-ec2-vpnconnection-cloudwatchlogoptionsspecification-bgploggrouparn

bgp_log_output_format

The desired output format for BGP logs to be sent to CloudWatch. Default format is json .

Valid values: json | text

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-cloudwatchlogoptionsspecification.html#cfn-ec2-vpnconnection-cloudwatchlogoptionsspecification-bgplogoutputformat

log_enabled

Enable or disable VPN tunnel logging feature. Default value is False .

Valid values: True | False

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-cloudwatchlogoptionsspecification.html#cfn-ec2-vpnconnection-cloudwatchlogoptionsspecification-logenabled

log_group_arn

The Amazon Resource Name (ARN) of the CloudWatch log group to send logs to.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-cloudwatchlogoptionsspecification.html#cfn-ec2-vpnconnection-cloudwatchlogoptionsspecification-loggrouparn

log_output_format

Set log format. Default format is json .

Valid values: json | text

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-cloudwatchlogoptionsspecification.html#cfn-ec2-vpnconnection-cloudwatchlogoptionsspecification-logoutputformat

IKEVersionsRequestListValueProperty

class CfnVPNConnectionPropsMixin.IKEVersionsRequestListValueProperty(*, value=None)

Bases: object

The IKE version that is permitted for the VPN tunnel.

Parameters:

value (Optional[str]) – The IKE version.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-ikeversionsrequestlistvalue.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_ec2 import mixins as ec2_mixins

i_kEVersions_request_list_value_property = {
    "value": "value"
}

Attributes

value

The IKE version.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-ikeversionsrequestlistvalue.html#cfn-ec2-vpnconnection-ikeversionsrequestlistvalue-value

Phase1DHGroupNumbersRequestListValueProperty

class CfnVPNConnectionPropsMixin.Phase1DHGroupNumbersRequestListValueProperty(*, value=None)

Bases: object

Specifies a Diffie-Hellman group number for the VPN tunnel for phase 1 IKE negotiations.

Parameters:

value (Union[int, float, None]) – The Diffie-Hellmann group number.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-phase1dhgroupnumbersrequestlistvalue.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_ec2 import mixins as ec2_mixins

phase1_dHGroup_numbers_request_list_value_property = ec2_mixins.CfnVPNConnectionPropsMixin.Phase1DHGroupNumbersRequestListValueProperty(
    value=123
)

Attributes

value

The Diffie-Hellmann group number.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-phase1dhgroupnumbersrequestlistvalue.html#cfn-ec2-vpnconnection-phase1dhgroupnumbersrequestlistvalue-value

Phase1EncryptionAlgorithmsRequestListValueProperty

class CfnVPNConnectionPropsMixin.Phase1EncryptionAlgorithmsRequestListValueProperty(*, value=None)

Bases: object

Specifies the encryption algorithm for the VPN tunnel for phase 1 IKE negotiations.

Parameters:

value (Optional[str]) – The value for the encryption algorithm.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-phase1encryptionalgorithmsrequestlistvalue.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_ec2 import mixins as ec2_mixins

phase1_encryption_algorithms_request_list_value_property = ec2_mixins.CfnVPNConnectionPropsMixin.Phase1EncryptionAlgorithmsRequestListValueProperty(
    value="value"
)

Attributes

value

The value for the encryption algorithm.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-phase1encryptionalgorithmsrequestlistvalue.html#cfn-ec2-vpnconnection-phase1encryptionalgorithmsrequestlistvalue-value

Phase1IntegrityAlgorithmsRequestListValueProperty

class CfnVPNConnectionPropsMixin.Phase1IntegrityAlgorithmsRequestListValueProperty(*, value=None)

Bases: object

Specifies the integrity algorithm for the VPN tunnel for phase 1 IKE negotiations.

Parameters:

value (Optional[str]) – The value for the integrity algorithm.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-phase1integrityalgorithmsrequestlistvalue.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_ec2 import mixins as ec2_mixins

phase1_integrity_algorithms_request_list_value_property = ec2_mixins.CfnVPNConnectionPropsMixin.Phase1IntegrityAlgorithmsRequestListValueProperty(
    value="value"
)

Attributes

value

The value for the integrity algorithm.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-phase1integrityalgorithmsrequestlistvalue.html#cfn-ec2-vpnconnection-phase1integrityalgorithmsrequestlistvalue-value

Phase2DHGroupNumbersRequestListValueProperty

class CfnVPNConnectionPropsMixin.Phase2DHGroupNumbersRequestListValueProperty(*, value=None)

Bases: object

Specifies a Diffie-Hellman group number for the VPN tunnel for phase 2 IKE negotiations.

Parameters:

value (Union[int, float, None]) – The Diffie-Hellmann group number.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-phase2dhgroupnumbersrequestlistvalue.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_ec2 import mixins as ec2_mixins

phase2_dHGroup_numbers_request_list_value_property = ec2_mixins.CfnVPNConnectionPropsMixin.Phase2DHGroupNumbersRequestListValueProperty(
    value=123
)

Attributes

value

The Diffie-Hellmann group number.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-phase2dhgroupnumbersrequestlistvalue.html#cfn-ec2-vpnconnection-phase2dhgroupnumbersrequestlistvalue-value

Phase2EncryptionAlgorithmsRequestListValueProperty

class CfnVPNConnectionPropsMixin.Phase2EncryptionAlgorithmsRequestListValueProperty(*, value=None)

Bases: object

Specifies the encryption algorithm for the VPN tunnel for phase 2 IKE negotiations.

Parameters:

value (Optional[str]) – The encryption algorithm.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-phase2encryptionalgorithmsrequestlistvalue.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_ec2 import mixins as ec2_mixins

phase2_encryption_algorithms_request_list_value_property = ec2_mixins.CfnVPNConnectionPropsMixin.Phase2EncryptionAlgorithmsRequestListValueProperty(
    value="value"
)

Attributes

value

The encryption algorithm.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-phase2encryptionalgorithmsrequestlistvalue.html#cfn-ec2-vpnconnection-phase2encryptionalgorithmsrequestlistvalue-value

Phase2IntegrityAlgorithmsRequestListValueProperty

class CfnVPNConnectionPropsMixin.Phase2IntegrityAlgorithmsRequestListValueProperty(*, value=None)

Bases: object

Specifies the integrity algorithm for the VPN tunnel for phase 2 IKE negotiations.

Parameters:

value (Optional[str]) – The integrity algorithm.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-phase2integrityalgorithmsrequestlistvalue.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_ec2 import mixins as ec2_mixins

phase2_integrity_algorithms_request_list_value_property = ec2_mixins.CfnVPNConnectionPropsMixin.Phase2IntegrityAlgorithmsRequestListValueProperty(
    value="value"
)

Attributes

value

The integrity algorithm.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-phase2integrityalgorithmsrequestlistvalue.html#cfn-ec2-vpnconnection-phase2integrityalgorithmsrequestlistvalue-value

VpnTunnelLogOptionsSpecificationProperty

class CfnVPNConnectionPropsMixin.VpnTunnelLogOptionsSpecificationProperty(*, cloudwatch_log_options=None)

Bases: object

Options for logging VPN tunnel activity.

Parameters:

cloudwatch_log_options (Union[IResolvable, CloudwatchLogOptionsSpecificationProperty, Dict[str, Any], None]) – Options for sending VPN tunnel logs to CloudWatch.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunnellogoptionsspecification.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_ec2 import mixins as ec2_mixins

vpn_tunnel_log_options_specification_property = ec2_mixins.CfnVPNConnectionPropsMixin.VpnTunnelLogOptionsSpecificationProperty(
    cloudwatch_log_options=ec2_mixins.CfnVPNConnectionPropsMixin.CloudwatchLogOptionsSpecificationProperty(
        bgp_log_enabled=False,
        bgp_log_group_arn="bgpLogGroupArn",
        bgp_log_output_format="bgpLogOutputFormat",
        log_enabled=False,
        log_group_arn="logGroupArn",
        log_output_format="logOutputFormat"
    )
)

Attributes

cloudwatch_log_options

Options for sending VPN tunnel logs to CloudWatch.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunnellogoptionsspecification.html#cfn-ec2-vpnconnection-vpntunnellogoptionsspecification-cloudwatchlogoptions

VpnTunnelOptionsSpecificationProperty

class CfnVPNConnectionPropsMixin.VpnTunnelOptionsSpecificationProperty(*, dpd_timeout_action=None, dpd_timeout_seconds=None, enable_tunnel_lifecycle_control=None, ike_versions=None, log_options=None, phase1_dh_group_numbers=None, phase1_encryption_algorithms=None, phase1_integrity_algorithms=None, phase1_lifetime_seconds=None, phase2_dh_group_numbers=None, phase2_encryption_algorithms=None, phase2_integrity_algorithms=None, phase2_lifetime_seconds=None, pre_shared_key=None, rekey_fuzz_percentage=None, rekey_margin_time_seconds=None, replay_window_size=None, startup_action=None, tunnel_inside_cidr=None, tunnel_inside_ipv6_cidr=None)

Bases: object

The tunnel options for a single VPN tunnel.

Parameters:
  • dpd_timeout_action (Optional[str]) – The action to take after DPD timeout occurs. Specify restart to restart the IKE initiation. Specify clear to end the IKE session. Valid Values: clear | none | restart Default: clear

  • dpd_timeout_seconds (Union[int, float, None]) – The number of seconds after which a DPD timeout occurs. Constraints: A value greater than or equal to 30. Default: 30

  • enable_tunnel_lifecycle_control (Union[bool, IResolvable, None]) – Turn on or off tunnel endpoint lifecycle control feature.

  • ike_versions (Union[IResolvable, Sequence[Union[IResolvable, IKEVersionsRequestListValueProperty, Dict[str, Any]]], None]) – The IKE versions that are permitted for the VPN tunnel. Valid values: ikev1 | ikev2

  • log_options (Union[IResolvable, VpnTunnelLogOptionsSpecificationProperty, Dict[str, Any], None]) – Options for logging VPN tunnel activity.

  • phase1_dh_group_numbers (Union[IResolvable, Sequence[Union[IResolvable, Phase1DHGroupNumbersRequestListValueProperty, Dict[str, Any]]], None]) – 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 | 24

  • phase1_encryption_algorithms (Union[IResolvable, Sequence[Union[IResolvable, Phase1EncryptionAlgorithmsRequestListValueProperty, Dict[str, Any]]], None]) – 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-16

  • phase1_integrity_algorithms (Union[IResolvable, Sequence[Union[IResolvable, Phase1IntegrityAlgorithmsRequestListValueProperty, Dict[str, Any]]], None]) – 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-512

  • phase1_lifetime_seconds (Union[int, float, None]) – The lifetime for phase 1 of the IKE negotiation, in seconds. Constraints: A value between 900 and 28,800. Default: 28800

  • phase2_dh_group_numbers (Union[IResolvable, Sequence[Union[IResolvable, Phase2DHGroupNumbersRequestListValueProperty, Dict[str, Any]]], None]) – 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 | 24

  • phase2_encryption_algorithms (Union[IResolvable, Sequence[Union[IResolvable, Phase2EncryptionAlgorithmsRequestListValueProperty, Dict[str, Any]]], None]) – 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-16

  • phase2_integrity_algorithms (Union[IResolvable, Sequence[Union[IResolvable, Phase2IntegrityAlgorithmsRequestListValueProperty, Dict[str, Any]]], None]) – 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-512

  • phase2_lifetime_seconds (Union[int, float, None]) – 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: 3600

  • pre_shared_key (Optional[str]) – 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).

  • rekey_fuzz_percentage (Union[int, float, None]) – 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: 100

  • rekey_margin_time_seconds (Union[int, float, None]) – 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: 270

  • replay_window_size (Union[int, float, None]) – The number of packets in an IKE replay window. Constraints: A value between 64 and 2048. Default: 1024

  • startup_action (Optional[str]) – 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 start for AWS to initiate the IKE negotiation. Valid Values: add | start Default: add

  • tunnel_inside_cidr (Optional[str]) – 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/16 range. 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

  • tunnel_inside_ipv6_cidr (Optional[str]) – 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::/8 range.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_ec2 import mixins as ec2_mixins

vpn_tunnel_options_specification_property = ec2_mixins.CfnVPNConnectionPropsMixin.VpnTunnelOptionsSpecificationProperty(
    dpd_timeout_action="dpdTimeoutAction",
    dpd_timeout_seconds=123,
    enable_tunnel_lifecycle_control=False,
    ike_versions=[{
        "value": "value"
    }],
    log_options=ec2_mixins.CfnVPNConnectionPropsMixin.VpnTunnelLogOptionsSpecificationProperty(
        cloudwatch_log_options=ec2_mixins.CfnVPNConnectionPropsMixin.CloudwatchLogOptionsSpecificationProperty(
            bgp_log_enabled=False,
            bgp_log_group_arn="bgpLogGroupArn",
            bgp_log_output_format="bgpLogOutputFormat",
            log_enabled=False,
            log_group_arn="logGroupArn",
            log_output_format="logOutputFormat"
        )
    ),
    phase1_dh_group_numbers=[ec2_mixins.CfnVPNConnectionPropsMixin.Phase1DHGroupNumbersRequestListValueProperty(
        value=123
    )],
    phase1_encryption_algorithms=[ec2_mixins.CfnVPNConnectionPropsMixin.Phase1EncryptionAlgorithmsRequestListValueProperty(
        value="value"
    )],
    phase1_integrity_algorithms=[ec2_mixins.CfnVPNConnectionPropsMixin.Phase1IntegrityAlgorithmsRequestListValueProperty(
        value="value"
    )],
    phase1_lifetime_seconds=123,
    phase2_dh_group_numbers=[ec2_mixins.CfnVPNConnectionPropsMixin.Phase2DHGroupNumbersRequestListValueProperty(
        value=123
    )],
    phase2_encryption_algorithms=[ec2_mixins.CfnVPNConnectionPropsMixin.Phase2EncryptionAlgorithmsRequestListValueProperty(
        value="value"
    )],
    phase2_integrity_algorithms=[ec2_mixins.CfnVPNConnectionPropsMixin.Phase2IntegrityAlgorithmsRequestListValueProperty(
        value="value"
    )],
    phase2_lifetime_seconds=123,
    pre_shared_key="preSharedKey",
    rekey_fuzz_percentage=123,
    rekey_margin_time_seconds=123,
    replay_window_size=123,
    startup_action="startupAction",
    tunnel_inside_cidr="tunnelInsideCidr",
    tunnel_inside_ipv6_cidr="tunnelInsideIpv6Cidr"
)

Attributes

dpd_timeout_action

The action to take after DPD timeout occurs.

Specify restart to restart the IKE initiation. Specify clear to end the IKE session.

Valid Values: clear | none | restart

Default: clear

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-dpdtimeoutaction

dpd_timeout_seconds

The number of seconds after which a DPD timeout occurs.

Constraints: A value greater than or equal to 30.

Default: 30

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-dpdtimeoutseconds

enable_tunnel_lifecycle_control

Turn on or off tunnel endpoint lifecycle control feature.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-enabletunnellifecyclecontrol

ike_versions

The IKE versions that are permitted for the VPN tunnel.

Valid values: ikev1 | ikev2

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-ikeversions

log_options

Options for logging VPN tunnel activity.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-logoptions

phase1_dh_group_numbers

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 | 24

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-phase1dhgroupnumbers

phase1_encryption_algorithms

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-16

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-phase1encryptionalgorithms

phase1_integrity_algorithms

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-512

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-phase1integrityalgorithms

phase1_lifetime_seconds

The lifetime for phase 1 of the IKE negotiation, in seconds.

Constraints: A value between 900 and 28,800.

Default: 28800

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-phase1lifetimeseconds

phase2_dh_group_numbers

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 | 24

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-phase2dhgroupnumbers

phase2_encryption_algorithms

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-16

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-phase2encryptionalgorithms

phase2_integrity_algorithms

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-512

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-phase2integrityalgorithms

phase2_lifetime_seconds

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: 3600

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-phase2lifetimeseconds

pre_shared_key

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).

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-presharedkey

rekey_fuzz_percentage

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: 100

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-rekeyfuzzpercentage

rekey_margin_time_seconds

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: 270

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-rekeymargintimeseconds

replay_window_size

The number of packets in an IKE replay window.

Constraints: A value between 64 and 2048.

Default: 1024

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-replaywindowsize

startup_action

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 start for AWS to initiate the IKE negotiation.

Valid Values: add | start

Default: add

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-startupaction

tunnel_inside_cidr

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/16 range. 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

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-tunnelinsidecidr

tunnel_inside_ipv6_cidr

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::/8 range.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-vpnconnection-vpntunneloptionsspecification.html#cfn-ec2-vpnconnection-vpntunneloptionsspecification-tunnelinsideipv6cidr