CreateVpnConnection - 创建IPsec连接

IPsec连接所在的地域ID。您可以通过调用DescribeRegions接口获取地域ID。

客户端Token，用于保证请求的幂等性。

从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。

创建单隧道模式的IPsec-VPN连接时支持配置该参数，且该参数必填。

用户网关的ID。

VPN网关实例ID。

IPsec连接的名称。

长度为1～100个字符，不能以http://或https://开头。

需要和本地数据中心互通的VPC侧的网段，用于第二阶段协商。

多个网段之间用半角逗号（,）分隔，例如：192.168.1.0/24,192.168.2.0/24。

关于IPsec连接路由模式的说明：

• 如果LocalSubnet和RemoteSubnet均输入为0.0.0.0/0，则表示您使用目的路由模式。
• 如果LocalSubnet和RemoteSubnet均输入具体的网段，则表示您使用感兴趣流模式。

需要和VPC互通的本地数据中心侧的网段，用于第二阶段协商。

多个网段之间用半角逗号（,）分隔，例如：192.168.3.0/24,192.168.4.0/24。

关于IPsec连接路由模式的说明：

• 如果LocalSubnet和RemoteSubnet均输入为0.0.0.0/0，则表示您使用目的路由模式。
• 如果LocalSubnet和RemoteSubnet均输入具体的网段，则表示您使用感兴趣流模式。

选择IPsec连接的配置是否立即生效。取值：

• true：是，配置完成后系统立即进行IPsec协议协商。

• false（默认值）：否，当有流量进入时系统才进行IPsec协议协商。

创建单隧道模式的IPsec-VPN连接时支持配置该参数。

第一阶段协商的配置信息：

• IkeConfig.Psk：预共享密钥，用于VPN网关与本地数据中心之间的身份认证。

  • 密钥长度为1~100个字符，支持数字、大小写英文字母以及以下字符。~!\`@#$%^&*()_-+={}[]|;:',.<>/?

  • 若您未指定预共享密钥，系统会随机生成一个16位的字符串作为预共享密钥。您可以调用DescribeVpnConnection接口查询系统自动生成的预共享密钥。

    说明 IPsec连接侧的预共享密钥需和本地数据中心侧的认证密钥一致，否则本地数据中心和VPN网关之间无法建立连接。

• IkeConfig.IkeVersion：IKE协议的版本。取值：ikev1或ikev2。默认值：ikev1。

  相对于IKEv1版本，IKEv2版本简化了SA的协商过程并且对于多网段的场景提供了更好的支持。

  如果VPN网关实例类型为国密型，则IKE版本仅支持ikev1。

• IkeConfig.IkeMode：IKE版本的协商模式。取值：main或aggressive。默认值：main。

  • main：主模式，协商过程安全性高。
  • aggressive：野蛮模式，协商快速且协商成功率高。

  如果VPN网关实例类型为国密型，则协商模式仅支持main。

• IkeConfig.IkeEncAlg：第一阶段协商的加密算法。

  如果VPN网关实例类型为普通型，则取值为aes、aes192、aes256、des或3des。默认值：aes。

  如果VPN网关实例类型为国密型，则取值为sm4（默认值）。

• IkeConfig.IkeAuthAlg：第一阶段协商的认证算法。

  如果VPN网关实例类型为普通型，则取值：md5、sha1、sha256、sha384、sha512。默认值：md5。

  如果VPN网关实例类型为国密型，则取值为sm3（默认值）。

• IkeConfig.IkePfs：第一阶段协商使用的Diffie-Hellman密钥交换算法。取值：group1、group2、group5、group14。默认值：group2。

• IkeConfig.IkeLifetime：第一阶段协商出的SA的生存周期。单位：秒。取值范围：0~86400。默认值：86400。

• IkeConfig.LocalId：VPN网关的标识，长度限制为100个字符，默认值为VPN网关的IP地址。

• IkeConfig.RemoteId：用户网关的标识，长度限制为100个字符，默认值为用户网关的IP地址。

创建单隧道模式的IPsec-VPN连接时支持配置该参数。

第二阶段协商的配置信息：

• IpsecConfig.IpsecEncAlg：第二阶段协商的加密算法。

  如果VPN网关实例类型为普通型，则取值为aes、aes192、aes256、des或3des。默认值：aes。

  如果VPN网关实例类型为国密型，则取值为sm4（默认值）。

• IpsecConfig. IpsecAuthAlg：第二阶段协商的认证算法。

  如果VPN网关实例类型为普通型，则取值：md5、sha1、sha256、sha384、sha512。默认值：md5。

  如果VPN网关实例类型为国密型，则取值为sm3（默认值）。

• IpsecConfig. IpsecPfs：第二阶段协商使用的Diffie-Hellman密钥交换算法。取值：disabled、group1、group2、group5、group14。默认值：group2。

• IpsecConfig. IpsecLifetime：第二阶段协商出的SA的生存周期。单位：秒。取值范围：0~86400。默认值：86400。

创建单隧道模式的IPsec-VPN连接时支持配置该参数。

健康检查配置信息：

• HealthCheckConfig.enable：是否开启健康检查，取值：true或false（默认值）。

• HealthCheckConfig.dip：健康检查的目的IP地址。

• HealthCheckConfig.sip：健康检查的源IP地址。

• HealthCheckConfig.interval：健康检查的重试间隔时间，单位：秒。默认值：3。

• HealthCheckConfig.retry：健康检查的重试发包次数。默认值：3。

是否自动配置路由。取值：

• true（默认值）：自动配置路由。

• false：不自动配置路由。

创建单隧道模式的IPsec-VPN连接时支持配置该参数。

是否开启DPD（对等体存活检测）功能。取值：

• true（默认值）：开启DPD功能。IPsec发起端会发送DPD报文用来检测对端的设备是否存活，如果在设定时间内未收到正确回应则认为对端已经断线，IPsec将删除ISAKMP SA和相应的IPsec SA，安全隧道同样也会被删除。

• false：不开启DPD功能，IPsec发起端不会发送DPD探测报文。

创建单隧道模式的IPsec-VPN连接时支持配置该参数。

是否开启NAT穿越功能。取值：

• true（默认值）：开启NAT穿越功能。开启后，IKE协商过程会删除对UDP端口号的验证过程，同时实现对VPN隧道中NAT网关设备的发现功能。

• false：不开启NAT穿越功能。

创建单隧道模式的IPsec-VPN连接时支持配置该参数。

BGP的配置信息：

• BgpConfig.EnableBgp：是否开启BGP功能。取值：true或false（默认值）。

• BgpConfig.LocalAsn：阿里云侧的自治系统号。自治系统号取值范围：1~4294967295。默认值：45104。

  支持按照两段位的格式进行输入，即：前16位比特.后16位比特。每个段位使用十进制输入。

  例如输入123.456，则表示自治系统号：123*65536+456=8061384。

• BgpConfig.TunnelCidr：IPsec隧道网段。该网段需是一个在169.254.0.0/16内的掩码长度为30的网段。

  说明 一个VPN网关实例下每个IPsec连接的IPsec隧道网段需保持唯一。

• LocalBgpIp：阿里云侧的BGP地址。该地址为IPsec隧道网段内的一个IP地址。

创建单隧道模式的IPsec-VPN连接时支持配置该参数。

如果当前VPN网关实例为国密型VPN网关，您需要配置对端的CA证书。

• 对于国密型VPN网关，创建IPsec连接时，此项必填。

• 对于普通型VPN网关，此项需要为空。

IPsec连接待添加的标签列表。

一次最多支持为IPsec连接添加20个标签。

配置隧道。

• 创建双隧道模式的IPsec-VPN连接时支持配置TunnelOptionsSpecification数组下的参数。
• 创建双隧道模式的IPsec-VPN连接时，您必须同时为IPsec-VPN连接添加主隧道和备隧道的配置。一个IPsec-VPN连接下仅支持添加主备两条隧道。

创建双隧道模式的IPsec-VPN连接时支持配置该参数。

是否为隧道开启BGP功能。取值：true或false（默认值）。