虚拟专用网络 VPN-更新VPN网关:请求消息

时间:2025-02-12 15:09:46

请求消息

  • 请求参数
    表2 请求参数

    名称

    类型

    是否必选

    描述

    vpn_gateway

    UpdateVgwRequestBodyContent object

    vpn_gateway对象。

    表3 UpdateVgwRequestBodyContent

    名称

    类型

    是否必选

    描述

    name

    String

    • 功能说明:VPN网关名称。
    • 取值范围:1-64个字符,支持数字、英文字母、中文(\u4e00 - \u9fa5)、_(下划线)、-(中划线)、.(点)。

    local_subnets

    Array of String

    • 功能说明:IPv4本端子网。本端子网是云上子网,该网段需要通过VPN与用户侧网络进行互通。单个网段格式示例:192.168.52.0/24。
    • 约束:当attachment_type配置为"vpc"时、且ip_version配置为"ipv4"时可填写,否则不填。每个VPN网关最多填写50个本端子网。

    local_subnets_v6

    Array of String

    • 功能说明:IPv6本端子网,本端子网是云上子网,该子网需要通过VPN与云下对端子网进行互通。单个子网格式示例:16af:cacc:1097::/48。
    • 约束:当attachment_type配置为"vpc"时、且ip_version配置为"ipv6"时可填写,否则不填。每个VPN网关最多填写50个本端子网。

    eip_id_1

    String

    • 功能说明:有效的EIP的ID,表示绑定新的EIP作为双活VPN网关使用的第一个EIP或主备VPN网关的主EIP。绑定新的EIP前必须先解绑掉原有的EIP。可以通过解绑弹性公网IP解绑VPN网关使用的EIP。
    • 约束:36位UUID,当network_type配置为public时可填写,否则不填。

    eip_id_2

    String

    • 功能说明:有效的EIP的ID,表示绑定新的EIP作为双活VPN网关使用的第二个EIP或主备VPN网关的备EIP。绑定新的EIP前必须先解绑掉原有的EIP。可以通过解绑弹性公网IP解绑VPN网关使用的EIP。
    • 约束:36位UUID,当network_type配置为public时可填写,否则不填。

    policy_template

    PolicyTemplate object

    • 功能说明:策略模板。
    • 约束:只有当VPN网关的规格为Professional1-NonFixedIP或Professional2-NonFixedIP时使用,用于更新网关的策略模板。
    表4 PolicyTemplate

    名称

    类型

    描述

    ike_policy

    IkePolicy object

    ike 策略对象。

    ipsec_policy

    IpsecPolicy object

    ipsec 策略对象。

    表5 IkePolicy

    名称

    类型

    描述

    encryption_algorithm

    String

    • 功能说明:加密算法。
    • 取值范围:aes-256-gcm-16,aes-128-gcm-16,aes-256,aes-192,aes-128。

    dh_group

    String

    • 功能说明:第一阶段密钥交换使用的DH组。
    • 取值范围:group14,group15,group16,group19,group20,group21,disable。

    authentication_algorithm

    String

    • 功能说明:认证算法。
    • 取值范围:sha2-512,sha2-384,sha2-256。

    lifetime_seconds

    Integer

    • 功能说明:表示SA的生存周期,当该生存周期超时后IKE SA将自动更新。
    • 取值范围:60-604800,单位:秒。
    表6 IpsecPolicy

    名称

    类型

    描述

    authentication_algorithm

    String

    • 功能说明:认证算法。
    • 取值范围:sha2-512,sha2-384,sha2-256。

    encryption_algorithm

    String

    • 功能说明:加密算法。
    • 取值范围:aes-256-gcm-16,aes-128-gcm-16,aes-256,aes-192,aes-128。

    pfs

    String

    • 功能说明:PFS使用的DH密钥组。
    • 取值范围:group14,group15,group16,group19,group20,group21,disable。

    lifetime_seconds

    Integer

    • 功能说明:表示配置IPSec连接建立的隧道以时间为基准的生存周期。
    • 取值范围:30-604800,单位:秒。
  • 请求样例
    1. 更新固定IP接入网关。
      PUT https://{Endpoint}/v5/{project_id}/vpn-gateways/{vgw_id}{    "vpn_gateway": {        "name": "vpngw-4321",        "local_subnets": [            "192.168.0.0/24"        ],        "eip_id_1": "f1469b4a-demo-a8df-va86-bb7de91cf493",        "eip_id_2": "6ad8e297-demo-a8df-va86-da0f885ccb98"    }}
    2. 更新非固定IP接入VPN网关策略模板。
      PUT https://{Endpoint}/v5/{project_id}/vpn-gateways/{vgw_id}{    "vpn_gateway":{        "policy_template":{            "ike_policy":{                "authentication_algorithm":"sha2-256",                "encryption_algorithm":"aes-128-gcm-16",                "dh_group":"group21",                "lifetime_seconds":86400            },            "ipsec_policy":{                "authentication_algorithm":"sha2-256",                "encryption_algorithm":"aes-128-gcm-16",                "pfs":"disable",                "lifetime_seconds":3600            }        }    }}
support.huaweicloud.com/api-vpn/vpn_api_0017.html