全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
专有网络 VPC

修改VPN连接

更新时间:2017-10-17 09:16:44

描述

本接口用于修改VPN连接信息

请求参数

参数名 类型 是否必须 描述
Action String 系统规定参数,取值:ModifyVpnConnectionAttribute
RegionId String 指定VPNConnection所在的地域
VpnConnectionId String VPNConnection的Id
Name String 实例的显示名称,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,“.”,“_”或“-”。
如果没有指定该参数,默认值为VpnConnectionId
不能以http:// 和 https:// 开头
LocalSubnet String 本端网段,CIDR格式,多个网段用逗号分隔
RemoteSubnet String 对端网段,CIDR格式,多个网段用逗号分隔
EffectImmediately Boolean 默认false 基本配置
IkeConfig JSON String IkeConfig.Psk 预共享密钥, 长度限制100个字符
IkeConfig. IkeVersion 版本,可选值: ikev1, ikev2; 默认ikev1
IkeConfig. IkeMode IkeVersion 为v1时必填, 可选值: main,aggressive; 默认main
IkeConfig. IkeEncAlg 可选值:aes,aes192,aes256,des,3des; 默认aes
IkeConfig.IkeAuthAlg 可选值:md5、sha1; 默认sha1
IkeConfig.IkePfs 可选值:group1,group2,group5,group14,group24; 默认group2
IkeConfig.IkeLifetime (IKE SA Lifetime,Long类型),取值范围[0,86400],单位为秒; 默认86400
IkeConfig.LocalId 本端标识,长度限制100个字符,默认填写vpn网关ip
IkeConfig.RemoteId 对端标识,长度限制100个字符,默认填写用户网关IP
IpsecConfig JSON String IpsecConfig. IpsecEncAlg 可选值:aes,aes192,aes256,des,3des;默认aes
IpsecConfig. IpsecAuthAlg 可选值:md5、sha1; 默认sha1
IpsecConfig. IpsecPfs 可选值:disabled,group1,group2,group5,group14,group24;默认group2
IpsecConfig. IpsecLifetime (Ipsec lifetime Long类型),取值范围[0,86400],单位为秒; 默认86400

返回参数

名称 类型 描述
VpnConnectionId String VPN连接ID
CustomerGatewayId String CustomerGateway唯一标识
VpnGatewayId String VPNGateway唯一标识
Name String VPN 连接名称
LocalSubnet String 本端网段
RemoteSubnet String 对端网段
CreateTime Long 创建时间
IkeConfig Object IkeConfig.Psk 预共享密钥
IkeConfig. IkeVersion 版本,ikev1/ikev2
IkeConfig. IkeMode IkeVersion 为v1时,必填
IkeConfig. IkeEncAlg 3DES、AES-128、AES-192、AES-256、DES
IkeConfig.IkeAuthAlg MD5、SHA1
IkeConfig.IkePfs Group1、Group2、Group5、Group14、Group24
IkeConfig.IkeLifetime IKE SA Lifetime,单位为秒
IkeConfig.LocalId 本端标识
IkeConfig.RemoteId 对端标识
IpsecConfig Object IpsecConfig. IpsecEncAlg 3DES、AES-128、AES-192、AES-256、DES
IpsecConfig. IpsecAuthAlg MD5、SHA1
IpsecConfig. IpsecPfs group1, group2
IpsecConfig. IpsecLifetime Ipsec lifetime 单位为秒

错误码

ErrCode Message Http Status 描述
InvalidCustomerGatewayId.NotFound Specified customer gateway id is not found 404 指定的用户网关不存在
InvalidVpnGatewayId.NotFound Specified vpn gateway is not found 404 指定的Instance 不存在
InvalidParam.%s Specified %s param is invalid 400 Right
Psk
LeftSubnet
RightSubnet
IkeVersion
IkeEncAlg
IkeAuthAlg
IkePfs
IkeLifeTime
LeftId
RightId
IpsecEncAlg
IpsecAuthAlg
IpSecLifetime
EffectImmediately

示例

请求示例

  1. https://vpc.aliyuncs.com/?Action=ModifyVpnConnectionAttribute
  2. &RegionID=cn-beijing
  3. &VpnConnectionId=vco-bp10lz7aejumd2vxoqgev
  4. &<公共请求参数>

返回示例

XML格式

  1. <ModifyVpnConnectionAttributeResponse>
  2. <Name>vpn连接测试</Name>
  3. <CustomerGatewayId>cgw-bp1pvpl9r9adju6l5nxck</CustomerGatewayId>
  4. <RemoteSubnet>2.2.2.0/24</RemoteSubnet>
  5. <IpsecConfig>
  6. <IpsecLifetime>86400</IpsecLifetime>
  7. <IpsecAuthAlg>sha1</IpsecAuthAlg>
  8. <IpsecPfs>group2</IpsecPfs>
  9. <IpsecEncAlg>aes</IpsecEncAlg>
  10. </IpsecConfig>
  11. <EffectImmediately>false</EffectImmediately>
  12. <VpnGatewayId>vpn-bp1q8bgx4xnkm2ogj0fiu</VpnGatewayId>
  13. <CreateTime>1492753817000</CreateTime>
  14. <VpnConnectionId>vco-bp10lz7aejumd2vxoqgev</VpnConnectionId>
  15. <RequestId>57070A3D-38F2-40A6-A1C9-DB14542EF54D</RequestId>
  16. <LocalSubnet>1.1.1.0/24,1.1.2.0/24</LocalSubnet>
  17. <IkeConfig>
  18. <IkeEncAlg>aes</IkeEncAlg>
  19. <RemoteId>139.196.32.167</RemoteId>
  20. <IkePfs>group2</IkePfs>
  21. <IkeAuthAlg>sha1</IkeAuthAlg>
  22. <Psk>pgw6dy7d1i8in7x5</Psk>
  23. <IkeMode>main</IkeMode>
  24. <IkeLifetime>86400</IkeLifetime>
  25. <IkeVersion>ikev1</IkeVersion>
  26. <LocalId>116.62.69.64</LocalId>
  27. </IkeConfig>
  28. </ModifyVpnConnectionAttributeResponse>

JSON格式

  1. {
  2. "Name":"vpn连接测试",
  3. "CustomerGatewayId":"cgw-bp1pvpl9r9adju6l5nxck",
  4. "RemoteSubnet":"2.2.2.0/24",
  5. "IpsecConfig":{
  6. "IpsecLifetime":86400,
  7. "IpsecAuthAlg":"sha1",
  8. "IpsecPfs":"group2",
  9. "IpsecEncAlg":"aes"
  10. },
  11. "EffectImmediately":false,
  12. "VpnGatewayId":"vpn-bp1q8bgx4xnkm2ogj0fiu",
  13. "CreateTime":1492753817000,
  14. "VpnConnectionId":"vco-bp10lz7aejumd2vxoqgev",
  15. "RequestId":"7DB79D0C-5F27-4AB5-995B-79BE55102F90",
  16. "LocalSubnet":"1.1.1.0/24,1.1.2.0/24",
  17. "IkeConfig":{
  18. "IkeEncAlg":"aes",
  19. "RemoteId":"139.196.32.167",
  20. "IkePfs":"group2",
  21. "IkeAuthAlg":"sha1",
  22. "Psk":"pgw6dy7d1i8in7x5",
  23. "IkeMode":"main",
  24. "IkeLifetime":86400,
  25. "IkeVersion":"ikev1",
  26. "LocalId":"116.62.69.64"
  27. }
  28. }
本文导读目录