1. 接口描述
本接口(ModifyVpnConnEx)用于修改 VPN 通道。
接口请求域名:vpc.api.qcloud.com
2. 输入参数
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 ModifyVpnConnEx。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
vpcId | 是 | string | 私有网络 ID,可使用 vpcId 或 unVpcId,建议使用 unVpcId,例如:vpc-03vihbk9,可通过 DescribeVpcEx 接口查询。 |
vpnGwId | 是 | String | 系统分配的 VPN 网关 ID,可使用 vpnGwId 或 unVpnGwId,建议 unVpnGwId,例如:vpngw-dystbrkv。可通过 DescribeVpnGw 接口查询。 |
vpnConnId | 是 | String | 系统分配的 VPN 通道 ID,可使用 vpnConnId 或 unVpnConnId,建议使用 unVpnConnId,例如:vpnx-ol6bcqp0。可通过 DescribeVpnConn 接口查询。 |
vpnConnName | 否 | String | 通道名称,可任意命名,但不得超过60个字符。 |
preSharedKey | 否 | String | 预共享密钥。 |
userGwCidrBlock.n | 否 | Array | 对端网段 CIDR 地址,可写多个,指定 vpc 可以和哪些 IDC 网段通信,后面升级为spdAcl(粒度更细),userGwCidrBlock 和 spdAcl 必须填一项。 |
spdAcl.n | 否 | Array | SPD 策略组,用户指定 VPC 内哪些网段可以和您 IDC 中哪些网段通信,由 userGwCidrBlock 升级而来,userGwCidrBlock 和 spdAcl 必须填一项,更多详见产品说明文档。 |
IKESet.n | 否 | Array | IKE 配置(Internet Key Exchange,因特网密钥交换),IKE 具有一套自我保护机制,用户配置网络安全协议,详见 VPN 连接-IKE 配置。 |
IPsecSet.n | 否 | Array | IPSec 配置,腾讯云提供 IPSec 安全会话设置,详见 VPN 连接-IPsec 配置。 |
IKE 配置详情
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
IKESet.propoEncryAlgorithm | 否 | String | IKE 配置,加密算法,可选值:'3des-cbc','aes-cbc-128','aes-cbc-192','aes-cbc-256','des-cbc',默认为3des-cbc,更多详见产品说明文档。 |
IKESet.propoAuthenAlgorithm | 否 | String | IKE 配置,认证算法:可选值:'md5','sha',默认为 md5,更多详见产品说明文档。 |
IKESet.exchangeMode | 否 | String | IKE 配置,协商模式:可选值:'aggressive','main',默认为 main,更多详见产品说明文档。 |
IKESet.localIdentity | 否 | String | IKE 配置,本端标识类型:可选值:'address','fqdn',默认为 address,更多详见产品说明文档。 |
IKESet.remoteIdentity | 否 | String | IKE 配置,对端标识类型:可选值:'address','fqdn',默认为 address,更多详见产品说明文档。 |
IKESet.localAddress | 否 | String | IKE 配置,本端标识,当 localIdentity 选为 address 时,localAddress 必填。 localAddress 默认为 VPN 网关公网 IP,更多详见产品说明文档。 |
IKESet.remoteAddress | 否 | String | IKE 配置,对端标识,当 remoteIdentity 选为 address 时,remoteAddress 必填,更多详见产品说明文档。 |
IKESet.localFqdnName | 否 | String | IKE 配置,本端标识,当 localIdentity 选为 fqdn 时,localFqdnName 必填,更多详见产品说明文档。 |
IKESet.remoteFqdnName | 否 | String | IKE 配置,对端标识,当 remoteIdentity 选为 fqdn 时,remoteFqdnName 必填,更多详见产品说明文档。 |
IKESet.dhGroupName | 否 | String | IKE配置,DH group,指定IKE交换密钥时使用的DH组,可选值:'group1','group2','group5','group14','group24',更多详见产品说明文档。 |
IKESet.ikeSaLifetimeSeconds | 否 | Int | IKE 配置,IKE SA Lifetime,单位:秒,设置 IKE SA 的生存周期,取值范围:60-604800,更多详见产品说明文档。 |
IKESet.encryptAlgorithm | 否 | String | IPsec 配置,加密算法,取值:'3des-cbc','aes-cbc-128','aes-cbc-192','aes-cbc-256','des-cbc','null',默认为3des-cbc,更多详见产品说明文档。 |
IPsec 配置详情
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
IPsecSet.integrityAlgorith | 否 | String | IPsec 配置,认证算法:可选值:'md5','sha',默认为 md5,更多详见产品说明文档。 |
IPsecSet.ipsecSaLifetimeSeconds | 否 | Int | IPsec 配置,IPsec SA lifetime(s):单位秒,取值范围:180-604800,更多详见产品说明文档。 |
IPsecSet.ipsecSaLifetimeTraffic | 否 | Int | IPsec 配置,IPsec SA lifetime(KB):单位KB,取值范围:2560-604800,更多详见产品说明文档。 |
IPsecSet.pfsDhGroup | 否 | String | IPsec 配置,PFS:可选值:'null','dh-group1','dh-group14','dh-group2','dh-group24','dh-group5',默认为 null,更多详见产品说明文档。 |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
code | Int | 错误码,0:成功,其他值:失败 |
message | String | 错误信息 |
data.taskId | Int | 任务 ID,操作结果可以用 taskId 查询,详见 查询任务执行结果接口。 |
4. 错误码表
以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见VPC错误码。
错误码 | 描述 |
---|---|
InvalidVpc.NotFound | 无效的 VPC。VPC 资源不存在,请再次核实您输入的资源信息是否正确,可通过 DescribeVpcEx 接口查询 VPC。 |
InvalidVpnGw.NotFound | 无效的 VPN 网关。VPN 网关资源不存在,请再次核实您输入的资源信息是否正确,可通过 DescribeVpnGw 接口查询 VPN 网关。 |
InvalidVpnGw.NotFound | 无效的 VPN 通道。VPN 通道资源不存在,请再次核实您输入的资源信息是否正确,可通过 DescribeVpnConn 接口查询 VPN 通道。 |
5. 示例
输入
https://vpc.api.qcloud.com/v2/index.php?Action=ModifyVpnConnEx &<公共请求参数> &vpcId=vpc-03vihbk9 &vpnGwId=vpngw-kfldykuz &vpnConnId=vpnx-ol6bcqp0 &userGwCidrBlock.0=10.100.2.0/24 &preSharedKey=tencenttest
输出
{
"code": 0,
"message": "",
"data": {
"vpnGwId": "vpngw-kfldykuz",
"vpcConnId": "vpnx-ol6bcqp0",
"taskId": 12614,
"vpcConnStatus": 2,
"preSharedKey": "tencenttest",
"userGwSubnetList": [
"10.100.2.0\/24"
],
"userGwId": 315
}
}