VPN连接
VPN连接
文档指南
请输入
- 文档首页
VPN连接API参考IPsec连接ModifyVpnConnectionTunnelAttributes-修改双隧道VPN连接配置信息
复制全文
下载 pdfModifyVpnConnectionTunnelAttributes-修改双隧道VPN连接配置信息
文档反馈
问问助手调用ModifyVpnConnectionTunnelAttributes接口，修改双隧道IPsec连接特有的配置信息，部分与单隧道共有的参数请调用ModifyVpnConnectionAttributes接口修改，例如名称、描述等。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action String 必选 示例值：ModifyVpnConnectionTunnelAttributes
要执行的操作，取值：ModifyVpnConnectionTunnelAttributes。
Version String 必选 示例值：2020-04-01
API版本信息。
VpnConnectionId String 必选 示例值：vgc-3tehy13n2l4c6c0v****
IPsec连接的ID。
TunnelId String 必选 示例值：tunnel-t2eryj3hl6gc60bv****
隧道连接的ID。
CustomerGatewayId String 可选 示例值：cgw-t2eryj3hl6gc60bv****
隧道关联的用户网关的ID。若传入的用户网关的IP地址为0.0.0.0，则NegotiateInstantly仅可传入false，IkeConfig中IkeConfig.Version仅可传入ikev1且IkeConfig.Mode仅可传入aggressive。
创建双隧道类型的IPsec连接时，该参数必填。
IkeConfig.Psk String 可选 示例值：Test123***
预共享密钥，用于第一阶段VPN网关与用户网关之间的身份认证。长度不超过100个字符，只可输入大小写字母、特殊符号~ ` | ! @ # $ % ^ ( ) - _ + = [ ] { } \ , . / : ;以及数字。
IkeConfig.Version String 可选 示例值：ikev1
IKE密钥交换协议的版本。取值如下
- ikev1
- ikev2
IkeConfig.Mode String 可选 示例值：main
第一阶段的协商模式。仅IkeConfig.Version为ikev1时需传入本参数。取值如下：
- main
- aggressive
IkeConfig.EncAlg String 可选 示例值：aes
第一阶段协商的加密算法。取值如下：
- aes
- aes192
- aes256
- des
- 3des
- sm4
IkeConfig.AuthAlg String 可选 示例值：sha1
第一阶段的认证算法。取值如下：
- sha1
- md5
- sha256
- sha384
- sha512
- sm3
IkeConfig.DhGroup String 可选 示例值：group2
第一阶段协商使用的DH（Diffie-Hellman）密钥交换算法。取值如下：
- group1
- group2
- group5
- group14
IkeConfig.Lifetime Integer 可选 示例值：86400
第一阶段协商的SA的生存时间，超过生存时间后，将重新发起协商。
- 取值范围：900～86400，单位：秒。
- 默认：86400。
IkeConfig.LocalId String 可选 示例值：
VPN网关的标识，用于第一阶段的协商，支持IP格式和FQDN( Fully Qualified Domain Name)完全合格域名/全称域名格式。
- 不传默认为当前所选VPN网关的出口IP地址。
- 若您手动设置为FQDN格式，协商模式推荐设置为“aggressive”。
- 长度不超过100个字符，只可输入大小写字母、特殊符号~ ` | ! @ # $ % ^ ( ) - _ + = [ ] { } \ , . / : ;以及数字。
IkeConfig.RemoteId String 可选 示例值：
用户网关的标识，用于第一阶段的协商，支持IP格式和FQDN( Fully Qualified Domain Name)完全合格域名/全称域名格式。
- 不传默认为当前所选用户网关的公网IP地址。
- 若您手动设置为FQDN格式，协商模式推荐设置为“aggressive”。
- 长度不超过100个字符，只可输入大小写字母、特殊符号~ ` | ! @ # $ % ^ ( ) - _ + = [ ] { } \ , . / : ;以及数字。
IpsecConfig.EncAlg String 可选 示例值：aes
第二阶段协商的加密算法。取值如下：
- aes
- aes192
- aes256
- des
- 3des
- sm4
IpsecConfig.AuthAlg String 可选 示例值：sha1
第二阶段协商的认证算法。取值如下：
- sha1
- md5
- sha256
- sha384
- sha512
- sm3
IpsecConfig.DhGroup String 可选 示例值：group2
第二阶段使用的DH（Diffie-Hellman）密钥交换算法。取值如下：
- group1
- group2
- group5
- group14
- disable（不配置DH算法）
若选择group1、group2、group5、group14，将默认开启PFS（Perfect Forward Secrecy）完美前向保密功能，对应的客户端也需要开启PFS功能。若客户端不支持PFS功能，此处需配置为“disable”。
IpsecConfig.Lifetime Integer 可选 示例值：86400
第二阶段协商的SA的生存时间，超过生存时间后，将重新发起协商。
- 取值范围：900～86400
- 单位：秒。
- 默认：86400。
BGPConfig.TunnelCidr String 可选 示例值：169.254.XX.XX/30
BGP 会话本端IP和对端IP所在的 CIDR 地址段。
- 该地址段需要在 169.254.0.0/16 网段内、掩码长度为 30 的网段。
- 如果EnableTunnelsBgp传入值为true，此参数必须填写。
BGPConfig.LocalBgpIP String 可选 示例值：169.254.XX.XX
火山引擎侧的 BGP 地址。
- 该地址必须为 IPsec 隧道网段内的一个 IP 地址。
- 如果EnableTunnelsBgp传入值为true，此参数必须填写。
NatTraversal Boolean 可选 示例值：false
是否开启NAT穿越功能。
- true：开启。NAT穿越（NAT Traversal）功能开启后，IKE协商时不会对UDP端口号进行验证，并且能够发现VPN连接隧道中NAT网关设备。
- false：不开启。
DpdAction String 可选 示例值：clear
DPD功能的状态。
- none：关闭DPD功能。
- clear：开启DPD功能，DPD超时后清除IKE SA。
- hold：开启DPD功能，DPD超时后保持当前状态，等待新的流量进入后重新建立连接。
- restart：开启DPD功能，DPD超时后立即重连。
DpdMode String 可选 示例值：on_demand
IPsec连接的DPD探测方式，取值如下：
- on_demand（默认）：按需。
- periodic：周期。
返回参数
RequestId String 示例值：0ED8D006-F706-4D23-88ED-E11ED28D****
请求ID。
请求示例
返回示例
错误码
最近更新时间：2026.09.18 15:13:19
这个页面对您有帮助吗？
有用
有用
无用
无用