更新时间:2025-04-15 GMT+08:00
分享

批量创建VPN连接

功能介绍

批量创建VPN连接,在同一个网关下同时创建1-2条VPN连接。

调用方法

请参见如何调用API

URI

POST /v5/{project_id}/vpn-connections/batch-create

表1 参数说明

名称

类型

是否必选

说明

project_id

String

项目ID,可以通过获取项目ID获取项目ID。

请求消息

  • 请求参数
    表2 请求参数

    名称

    类型

    是否必选

    描述

    vpn_connections

    Array of

    CreateVpnConnectionRequestBodyContent object

    vpn_connection对象数组,范围1-2。

    表3 CreateVpnConnectionRequestBodyContent

    名称

    类型

    是否必选

    描述

    name

    String

    • 功能说明:VPN连接名称,不填时会自动生成格式为vpn-****的名称。例如:vpn-13be。
    • 取值范围:1-64个字符,支持数字、英文字母、中文(\u4e00 - \u9fa5)、_(下划线)、-(中划线)、.(点)。

    vgw_id

    String

    • 功能说明:VPN网关ID。
    • 约束:36位UUID,当VPN网关的flavor配置为GM时,VPN网关必须已导入过VPN网关证书。创建2条连接时,vgw_id需相同。

    可以通过查询VPN网关列表查看VPN网关的ID。

    vgw_ip

    String

    • 功能说明:
      • 当VPN网关的network_type配置为public时,vgw_ip为VPN网关EIP的ID。
      • 当VPN网关的network_type配置为private时,vgw_ip为VPN网关使用的接入私网IP。
    • 约束:36位UUID或点分十进制IPv4地址(如192.168.45.7)。

    可以通过查询VPN网关查看VPN网关所使用的EIP的ID或接入私网IP。

    style

    String

    • 功能说明:连接模式。
    • 取值范围:

      policy: 策略模式。

      static: 静态路由模式。

      bgp: bgp路由模式。

      policy-template: 策略模板模式。

    • 默认值:static。

    cgw_id

    String

    • 功能说明:对端网关ID。
    • 约束:36位UUID,当VPN网关的flavor配置为GM时,对端网关必须已导入过对端网关证书。

    peer_subnets

    Array of String

    • 功能说明:IPv4对端子网。
    • 约束:
      • IP协议版本号为IPv6时不填;VPN网关的关联模式为er且style字段为policy或bgp时不填;其他场景必填。
      • 部分网段是VPC预留网段,不能作为对端子网,比如100.64.0.0/10,214.0.0.0/8。
      • 每个VPN连接最多填写50个对端子网。

    peer_subnets_v6

    Array of String

    • 功能说明:IPv6对端子网。
    • 约束:
      • IP协议版本号为IPv4时不填;VPN网关的关联模式为er且style字段为policy或bgp时不填,其他场景必填。
      • 每个VPN连接最多填写50个对端子网。

    tunnel_local_address

    String

    • 功能说明:路由模式下配置在VPN网关上的tunnel接口地址。例如:169.254.76.1/30。
    • 约束:
      • 前16位必须是169.254,不能使用169.254.195.xxx。
      • 掩码长度必须是30。必须和tunnel_peer_address在同一个30掩码范围。
      • 应填写网段中的主机地址。

    tunnel_peer_address

    String

    • 功能说明:路由模式下配置在用户侧设备上的tunnel接口地址。例如:169.254.76.2/30。
    • 约束:
      • 前16位必须是169.254,不能使用169.254.195.xxx。
      • 掩码长度必须是30。必须和tunnel_local_address在同一个30掩码范围。
      • 应填写网段中的主机地址。

    enable_nqa

    Boolean

    • 功能说明:开启NQA检测。
    • 取值范围:true,false。
    • 默认值:false。
    • 约束:当style为static时填写,否则不填。

    enable_hub

    Boolean

    • 功能说明:开启分支互联。
    • 取值范围:true,false。
    • 默认值:false。
    • 约束:当style为BGP时填写,否则不填。

    psk

    String

    • 功能说明:预共享密钥。

      当VPN网关的flavor配置为GM时,此字段不用填写,否则必填。

    • 约束:8-128个字符,只能包含大写字母、小写字母、数字和特殊字符(~!@#$%^()-_+={ },./:;)且至少包含四种字符的三种。

    policy_rules

    Array of PolicyRule object

    功能说明:IPv4策略模式的策略规则组。

    约束:最多填写5个。仅当style为policy且VPN网关的IP协议版本号为IPv4时填写。

    policy_rules_v6

    Array of PolicyRule object

    功能说明:IPv6策略模式的策略规则组。

    约束:最多填写5个。仅当style为policy且VPN网关的IP协议版本号为IPv6时填写。

    ikepolicy

    IkePolicy object

    ike策略对象。

    ipsecpolicy

    IpsecPolicy object

    ipsec策略对象。

    ha_role

    String

    • 功能说明:双活模式VPN网关下创建连接可不填,主备模式VPN网关下创建连接时,'master'表示主连接,'slave'表示备连接。
    • 默认值:master。
    • 约束:主备模式VPN网关在主EIP或者主私网地址建立的连接必须填'master',在备EIP或者备私网地址建立的连接必须填'slave'。

    tags

    Array of VpnResourceTag object

    • 功能说明:标签列表。
    • 约束:最多填写20个。
    表4 PolicyRule

    名称

    类型

    是否必选

    描述

    source

    String

    • 功能说明:源地址网段,网段IPv4/IPv6格式需与VPN网关的IP协议版本匹配。
    • 约束:不能与其他PolicyRule下的source相同。

    destination

    Array of String

    • 功能说明:目的地址网段,网段IPv4/IPv6格式需与VPN网关的IP协议版本匹配。

      单个IPv4网段格式示例:192.168.52.0/24。

      单个IPv6网段格式示例:16af:cacc:1097::/48。

    • 约束:每个PolicyRule最多填写50个。
    表5 IkePolicy

    名称

    类型

    是否必选

    描述

    ike_version

    String

    • 功能说明:IKE版本号。
    • 取值范围:

      当VPN网关的flavor配置为GM时,取值范围为v1。

      其他场景下取值范围为v1,v2。

      v1,v2。

    • 默认值:

      当VPN网关的flavor配置为GM时,默认值为v1;

      其他场景下,默认值为v2。

      v2。

    phase1_negotiation_mode

    String

    • 功能说明:协商模式。
    • 取值范围:

      当VPN网关的flavor配置为GM时,取值范围为main。

      其他场景下取值范围为main,aggressive。

      main:主模式,协商过程安全性高。

      aggressive:野蛮模式,协商快速且协商成功率高。

    • 默认值:main。
    • 约束:IKE版本为v1时填写,为v2时不填。

    authentication_algorithm

    String

    • 功能说明:认证算法。
    • 取值范围:

      当VPN网关的flavor配置为GM时,取值范围为sm3。

      其他场景下取值范围为sha2-512,sha2-384,sha2-256,sha1,md5。

      sha2-512,sha2-384,sha2-256,sha1,md5。

      其中,sha1和md5安全性较低,请慎用。

    • 默认值:

      当VPN网关的flavor配置为GM时,默认值为sm3。

      其他场景下,默认值为sha2-256。

      sha2-256。

    encryption_algorithm

    String

    • 功能说明:加密算法。
    • 取值范围:

      当VPN网关的flavor配置为GM时,取值范围为sm4。

      其他场景下取值范围为aes-256-gcm-16,aes-128-gcm-16,aes-256,aes-192,aes-128,3des。

      aes-256-gcm-16,aes-128-gcm-16,aes-256,aes-192,aes-128,3des。

      其中,3des,aes-128,aes-192,aes-256安全性较低,请慎用。

    • 默认值:

      当VPN网关的flavor配置为GM时,默认值为sm4;

      其他场景下,默认值为aes-128。

      aes-128。

    dh_group

    String

    • 功能说明:第一阶段密钥交换使用的DH组。

      当VPN网关的flavor配置为GM时,该字段不用填写。

    • 取值范围:group1,group2,group5,group14,group15,group16,group19,group20,group21。

      其中,group1,group2,group5,group14安全性较低,请慎用。

    • 默认值:group15。

    authentication_method

    String

    • 功能说明:ike协商时的认证方法。
    • 取值范围:

      pre-share:预共享密钥。

      digital-envelope-v2:国密数字信封。

    • 默认值: 非国密网关pre-share,国密网关digital-envelope-v2。

    lifetime_seconds

    Integer

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

    local_id_type

    String

    • 功能说明:本端ID类型。

      当VPN网关的flavor配置为GM时,该字段不用填写。

    • 取值范围:
      • ip。
      • fqdn。
    • 默认值:ip。

    local_id

    String

    • 功能说明:本端ID。

      当VPN网关的flavor配置为GM时,该字段不用填写。

    • 约束:

      当local_id_type为ip时,可不填,填写需满足IPv4格式。

      当local_id_type为fqdn时,最大长度255个字符,只能由大小写字母、数字和特殊符号组成,不支持以下特殊字符:&、<、>、[、]、\、空格、?,区分大小写。当local_id_type为fqdn时必须填写,需要和对端设备的peer_id一致。

    peer_id_type

    String

    • 功能说明:对端ID类型。

      当VPN网关的flavor配置为GM时,该字段不用填写。

    • 取值范围:
      • ip。
      • fqdn。
    • 默认值:ip。

    peer_id

    String

    • 功能说明:对端ID。

      当VPN网关的flavor配置为GM时,该字段不用填写。

    • 约束:

      当local_id_type为ip时,可不填,填写需满足IPv4格式。

      当local_id_type为fqdn时,最大长度255个字符,只能由大小写字母、数字和特殊符号组成,不支持以下特殊字符:&、<、>、[、]、\、空格、?,区分大小写。当peer_id_type为fqdn时必须填写,需要和对端设备的local_id一致。

    dpd

    Dpd object

    对等体存活检测对象。

    表6 Dpd

    名称

    类型

    是否必选

    描述

    timeout

    Integer

    • 功能说明:对等体存活检测报文重传间隔。
    • 取值范围:2-60,单位:秒。
    • 默认值:15。

    interval

    Integer

    • 功能说明:对等体存活检测空闲时间。
    • 取值范围:10-3600,单位:秒。
    • 默认值:30。

    msg

    String

    • 功能说明:对等体存活检测报文格式。
    • 取值范围:

      seq-hash-notify:指定DPD报文中的载荷顺序是hash-notify。

      seq-notify-hash:指定DPD报文中的载荷顺序是notify-hash。

    • 默认值:seq-hash-notify。
    表7 IpsecPolicy

    名称

    类型

    是否必选

    描述

    authentication_algorithm

    String

    • 功能说明:认证算法。
    • 取值范围:

      当VPN网关的flavor配置为GM时,取值范围为sm3。

      其他场景下取值范围为sha2-512,sha2-384,sha2-256,sha1,md5。

      sha2-512,sha2-384,sha2-256,sha1,md5。

      其中,sha1和md5安全性较低,请慎用。

    • 默认值:

      当VPN网关的flavor配置为GM时,默认值为sm3。

      其他场景下,默认值为sha2-256。

      sha2-256。

    encryption_algorithm

    String

    • 功能说明:加密算法。
    • 取值范围:

      当VPN网关的flavor配置为GM时,取值范围为sm4。

      其他场景下取值范围为aes-256-gcm-16,aes-128-gcm-16,aes-256,aes-192,aes-128,3des。

      其中,3des,aes-128,aes-192,aes-256安全性较低,请慎用。

    • 默认值:

      当VPN网关的flavor配置为GM时,默认值为sm4。

      其他场景下,默认值为aes-128。

      aes-128。

    pfs

    String

    • 功能说明:PFS使用的DH密钥组。

      当VPN网关的flavor配置为GM时,该字段不用填写。

    • 取值范围:group1,group2,group5,group14,group15,group16,group19,group20,group21,disable。

      其中,group1,group2,group5,group14安全性较低,请慎用。

    • 默认值:group15。

    transform_protocol

    String

    • 功能说明:传输协议。
    • 取值范围:

      esp:封装安全协议。

    • 默认值:esp。

    lifetime_seconds

    Integer

    • 功能说明:表示配置IPSec连接建立的隧道以时间为基准的生存周期。
    • 取值范围:30-604800,单位:秒。
    • 默认值:3600。

    encapsulation_mode

    String

    • 功能说明:报文封装模式。
    • 取值范围:

      tunnel:隧道模式。

    • 默认值:tunnel。
    表8 VpnResourceTag

    名称

    类型

    是否必选

    描述

    key

    String

    • 功能说明:标签的键。
    • 取值范围:1-128个字符,支持数字、英文字母、中文、西班牙语、葡语、空格,以及以下字符:_.:=+-@。

    value

    String

    • 功能说明:标签的值。
    • 取值范围:0-255个字符,支持数字、英文字母、中文、西班牙语、葡语、空格,以及以下字符:_.:=+-@。
  • 请求样例
    1. 批量创建静态路由模式连接。
      POST https://{Endpoint}/v5/{project_id}/vpn-connections/batch-create
      
      {
          "vpn_connections": [
              {
                  "vgw_ip": "0d0f4af1-42b9-41eb-97b9-b4d41a0bf9c4",
                  "cgw_id": "12f3577a-cbd8-4602-b68c-ecbf792fcec5",
                  "vgw_id": "8030f6d6-32a8-4d20-a7f8-50a7a826e2f8",
                  "peer_subnets": [
                      "192.168.2.0/24"
                  ],
                  "psk": "abcd****"
              },
              {
                  "vgw_ip": "1fb97767-d780-4d8b-83bb-6f878f662005",
                  "cgw_id": "12f3577a-cbd8-4602-b68c-ecbf792fcec5",
                  "vgw_id": "8030f6d6-32a8-4d20-a7f8-50a7a826e2f8",
                  "peer_subnets": [
                      "192.168.2.0/24"
                  ],
                  "psk": "abcd****"
              }
          ]
      }
    2. 批量创建策略模式连接。
      POST https://{Endpoint}/v5/{project_id}/vpn-connections/batch-create
      
      {
          "vpn_connections": [
              {
                  "vgw_ip": "0d0f4af1-42b9-41eb-97b9-b4d41a0bf9c4",
                  "cgw_id": "12f3577a-cbd8-4602-b68c-ecbf792fcec5",
                  "vgw_id": "8030f6d6-32a8-4d20-a7f8-50a7a826e2f8",
                  "style": "policy",
                  "peer_subnets": [
                      "192.168.2.0/24"
                  ],
                  "psk": "abcd****",
                  "policy_rules": [
                      {
                          "source": "10.0.0.0/24",
                          "destination": [
                              "192.168.0.0/24"
                          ]
                      }
                  ]
              },
              {
                  "vgw_ip": "1fb97767-d780-4d8b-83bb-6f878f662005",
                  "cgw_id": "12f3577a-cbd8-4602-b68c-ecbf792fcec5",
                  "vgw_id": "8030f6d6-32a8-4d20-a7f8-50a7a826e2f8",
                  "style": "policy",
                  "peer_subnets": [
                      "192.168.2.0/24"
                  ],
                  "psk": "abcd****",
                  "policy_rules": [
                      {
                          "source": "10.0.0.0/24",
                          "destination": [
                              "192.168.0.0/24"
                          ]
                      }
                  ]
              }
          ]
      }
    3. 批量创建bgp路由模式连接。
      POST https://{Endpoint}/v5/{project_id}/vpn-connections/batch-create
      
      {
          "vpn_connections": [
              {
                  "name": "vpn-1655",
                  "vgw_ip": "0d0f4af1-42b9-41eb-97b9-b4d41a0bf9c4",
                  "cgw_id": "12f3577a-cbd8-4602-b68c-ecbf792fcec5",
                  "vgw_id": "8030f6d6-32a8-4d20-a7f8-50a7a826e2f8",
                  "style": "bgp",
                  "peer_subnets": [
                      "192.168.2.0/24"
                  ],
                  "tunnel_local_address": "169.254.56.225/30",
                  "tunnel_peer_address": "169.254.56.226/30",
                  "psk": "abcd****",
                  "ikepolicy": {
                      "ike_version": "v2",
                      "authentication_algorithm": "sha2-512",
                      "encryption_algorithm": "aes-256",
                      "dh_group": "group16",
                      "lifetime_seconds": 172800,
                      "local_id_type": "fqdn",
                      "local_id": "123***",
                      "peer_id_type": "fqdn",
                      "peer_id": "456***",
                      "dpd": {
                          "timeout": 30,
                          "interval": 60,
                          "msg": "seq-notify-hash"
                      }
                  },
                  "ipsecpolicy": {
                      "authentication_algorithm": "sha2-512",
                      "encryption_algorithm": "aes-256",
                      "pfs": "group16",
                      "transform_protocol": "esp",
                      "lifetime_seconds": 7200,
                      "encapsulation_mode": "tunnel"
                  }
              },
              {
                  "name": "vpn-1341",
                  "vgw_ip": "1fb97767-d780-4d8b-83bb-6f878f662005",
                  "cgw_id": "12f3577a-cbd8-4602-b68c-ecbf792fcec5",
                  "vgw_id": "8030f6d6-32a8-4d20-a7f8-50a7a826e2f8",
                  "style": "bgp",
                  "peer_subnets": [
                      "192.168.2.0/24"
                  ],
                  "tunnel_local_address": "169.254.56.225/30",
                  "tunnel_peer_address": "169.254.56.226/30",
                  "psk": "abcd****",
                  "ikepolicy": {
                      "ike_version": "v2",
                      "authentication_algorithm": "sha2-512",
                      "encryption_algorithm": "aes-256",
                      "dh_group": "group16",
                      "lifetime_seconds": 172800,
                      "local_id_type": "fqdn",
                      "local_id": "123***",
                      "peer_id_type": "fqdn",
                      "peer_id": "456***",
                      "dpd": {
                          "timeout": 30,
                          "interval": 60,
                          "msg": "seq-notify-hash"
                      }
                  },
                  "ipsecpolicy": {
                      "authentication_algorithm": "sha2-512",
                      "encryption_algorithm": "aes-256",
                      "pfs": "group16",
                      "transform_protocol": "esp",
                      "lifetime_seconds": 7200,
                      "encapsulation_mode": "tunnel"
                  }
              }
          ]
      }
      

响应消息

  • 响应参数

    返回状态码为 201: successful operation。

    表9 响应Body参数列表

    名称

    类型

    描述

    vpn_connections

    Array of

    CreateResponseVpnConnection object

    vpn_connections对象数组。

    request_id

    String

    请求ID。

    表10 CreateResponseVpnConnection

    名称

    类型

    描述

    id

    String

    • 功能说明:VPN连接ID。
    • 格式:36位UUID。

    name

    String

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

    vgw_id

    String

    • 功能说明:VPN网关ID。
    • 格式:36位UUID。

    vgw_ip

    String

    • 功能说明: VPN网关EIP的ID或接入私网IP。
    • 格式:36位UUID或点分十进制IPv4地址(如192.168.45.7)。

    style

    String

    • 功能说明:连接模式。
    • 取值范围:

      POLICY: 策略模式。

      STATIC: 静态路由模式。

      BGP: bgp路由模式。

      POLICY-TEMPLATE: 策略模板模式。

    cgw_id

    String

    • 功能说明:对端网关ID。
    • 格式:36位UUID。

    peer_subnets

    Array of String

    IPv4对端子网。当VPN网关的关联模式为ER并且style字段为BGP或POLICY、或VPN网关的IP协议版本号为IPv6时不返回。

    peer_subnets_v6

    Array of String

    IPv6对端子网。当VPN网关的关联模式为ER并且style字段为BGP或POLICY、或VPN网关的IP协议版本号为IPv4时不返回。

    tunnel_local_address

    String

    路由模式下配置在VPN网关上的tunnel接口地址。仅当style为STATIC或BGP时有效。

    tunnel_peer_address

    String

    路由模式下配置在用户侧设备上的tunnel接口地址。仅当style为STATIC或BGP时有效。

    enable_nqa

    Boolean

    • 功能说明:开启NQA检测。仅当style为STATIC时返回。
    • 取值范围:true,false。

    policy_rules

    Array of PolicyRule objects

    IPv4策略模式的策略规则组。仅当style为POLICY且VPN网关的IP协议版本号为IPv4时返回实际的策略规则组。

    policy_rules_v6

    Array of PolicyRule objects

    IPv6策略模式的策略规则组。仅当style为POLICY且VPN网关的IP协议版本号为IPv6时返回实际的策略规则组。

    ikepolicy

    IkePolicy object

    ike策略对象。

    ipsecpolicy

    IpsecPolicy object

    ipsec策略对象。

    created_at

    String

    • 创建时间。
    • UTC时间格式:yyyy-MM-ddTHH:mm:ssZ。

    updated_at

    String

    • 最后一次更新时间。
    • UTC时间格式:yyyy-MM-ddTHH:mm:ssZ。

    enterprise_project_id

    String

    • 功能说明:企业项目ID。
    • 格式:36位UUID。与vgw_id所标识VPN网关的企业项目ID一致。

    ha_role

    String

    • 功能说明:主备模式VPN网关下的连接时,'master'表示主连接,'slave'表示备连接。双活模式下的连接ha_role都是'master'。
    • 默认值:master。

    tags

    Array of VpnResourceTag objects

    标签列表。

    表11 PolicyRule

    名称

    类型

    描述

    source

    String

    源地址网段。

    destination

    Array of String

    目的地址网段。单个IPv4网段格式示例:192.168.52.0/24。单个IPv6网段格式示例:16af:cacc:1097::/48。每个PolicyRule最多返回50个。

    表12 IkePolicy

    名称

    类型

    描述

    ike_version

    String

    • 功能说明:IKE版本号。
    • 取值范围:v1, v2。

    phase1_negotiation_mode

    String

    • 功能说明:协商模式。仅当IKE版本为v1时返回。
    • 取值范围:

      main:主模式,协商过程安全性高。

      aggressive:野蛮模式,协商快速且协商成功率高。

    authentication_algorithm

    String

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

    encryption_algorithm

    String

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

    dh_group

    String

    • 功能说明:第一阶段密钥交换使用的DH组,当VPN网关flavor为GM时不返回。
    • 取值范围:group1,group2,group5,group14,group15,group16,group19,group20,group21。

    authentication_method

    String

    • 功能说明:ike协商时的认证方法。
    • 取值范围:

      pre-share:预共享密钥。

      digital-envelope-v2:国密数字信封。

    lifetime_seconds

    Integer

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

    local_id_type

    String

    • 功能说明:本端ID类型,当VPN网关flavor为GM时不返回。
    • 取值范围:
      • ip。
      • fqdn。

    local_id

    String

    本端ID。当local_id_type为ip时返回创建或更新VPN连接时指定的本端ID,如果未指定本端ID则返回VPN连接所使用的VPN网关IP;当local_id_type为fqdn时返回创建或更新VPN连接时指定的本端ID。

    当VPN网关flavor为GM时不返回。

    peer_id_type

    String

    • 功能说明:对端ID类型,当VPN网关flavor为GM时不返回。
    • 取值范围:
      • ip。
      • fqdn。

    peer_id

    String

    对端ID。当peer_id_type为ip时返回创建或更新VPN连接时指定的对端ID,如果未指定则返回对端网关的IP;当peer_id_type为fqdn时返回创建或更新VPN连接时指定的对端ID。

    当VPN网关flavor为GM时不返回。

    dpd

    Dpd object

    对等体存活检测对象。

    表13 Dpd

    名称

    类型

    描述

    timeout

    Integer

    • 功能说明:对等体存活检测报文重传间隔。
    • 取值范围:2-60,单位:秒。

    interval

    Integer

    • 功能说明:对等体存活检测空闲时间。
    • 取值范围:10-3600,单位:秒。

    msg

    String

    • 功能说明:对等体存活检测报文格式。
    • 取值范围:

      seq-hash-notify:指定DPD报文中的载荷顺序是hash-notify。

      seq-notify-hash:指定DPD报文中的载荷顺序是notify-hash。

    表14 IpsecPolicy

    名称

    类型

    描述

    authentication_algorithm

    String

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

    encryption_algorithm

    String

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

    pfs

    String

    • 功能说明:PFS使用的DH密钥组,当VPN网关flavor为GM时不返回。
    • 取值范围:group1,group2,group5,group14,group15,group16,group19,group20,group21,disable。

    transform_protocol

    String

    • 功能说明:传输协议。
    • 取值范围:

      esp:封装安全协议。

    lifetime_seconds

    Integer

    • 功能说明:表示配置IPSec连接建立的隧道以时间为基准的生存周期。
    • 取值范围:30-604800,单位:秒。

    encapsulation_mode

    String

    • 功能说明:报文封装模式。
    • 取值范围:

      tunnel:隧道模式。

    表15 VpnResourceTag

    名称

    类型

    描述

    key

    String

    • 功能说明:标签的键。
    • 取值范围:1-128个字符,支持数字、英文字母、中文、西班牙语、葡语、空格,以及以下字符:_.:=+-@。

    value

    String

    • 功能说明:标签的值。
    • 取值范围:0-255个字符,支持数字、英文字母、中文、西班牙语、葡语、空格,以及以下字符:_.:=+-@。
    • 响应样例
      1. 批量创建静态路由模式连接的响应。
        {
            "vpn_connections": [
                {
                    "id": "cf91c03c-9679-495f-a201-3622a1aec817",
                    "name": "vpn-b8fa",
                    "vgw_id": "8030f6d6-32a8-4d20-a7f8-50a7a826e2f8",
                    "vgw_ip": "0d0f4af1-42b9-41eb-97b9-b4d41a0bf9c4",
                    "style": "STATIC",
                    "cgw_id": "12f3577a-cbd8-4602-b68c-ecbf792fcec5",
                    "peer_subnets": [
                        "192.168.2.0/24"
                    ],
                    "tunnel_local_address": "169.254.12.37/30",
                    "tunnel_peer_address": "169.254.12.38/30",
                    "enable_nqa": false,
                    "policy_rules": [],
                    "ikepolicy": {
                        "ike_version": "v2",
                        "authentication_algorithm": "sha2-256",
                        "encryption_algorithm": "aes-128",
                        "dh_group": "group15",
                        "authentication_method": "pre-share",
                        "lifetime_seconds": 86400,
                        "local_id_type": "ip",
                        "local_id": "10.***.***.173",
                        "peer_id_type": "ip",
                        "peer_id": "2.***.***.2",
                        "dpd": {
                            "interval": 30,
                            "timeout": 15,
                            "msg": "seq-hash-notify"
                        }
                    },
                    "ipsecpolicy": {
                        "authentication_algorithm": "sha2-256",
                        "encryption_algorithm": "aes-128",
                        "pfs": "group15",
                        "transform_protocol": "esp",
                        "lifetime_seconds": 3600,
                        "encapsulation_mode": "tunnel"
                    },
                    "created_at": "2025-02-21T03:53:23.557Z",
                    "updated_at": "2025-02-21T03:53:23.557Z",
                    "enterprise_project_id": "0",
                    "ha_role": "master",
                    "tags": [],
                    "policy_rules_v6": []
                },
                {
                    "id": "64c09578-a23c-4d9d-9c64-56b2f9a74695",
                    "name": "vpn-ec21",
                    "vgw_id": "8030f6d6-32a8-4d20-a7f8-50a7a826e2f8",
                    "vgw_ip": "1fb97767-d780-4d8b-83bb-6f878f662005",
                    "style": "STATIC",
                    "cgw_id": "12f3577a-cbd8-4602-b68c-ecbf792fcec5",
                    "peer_subnets": [
                        "192.168.2.0/24"
                    ],
                    "tunnel_local_address": "169.254.60.229/30",
                    "tunnel_peer_address": "169.254.60.230/30",
                    "enable_nqa": false,
                    "policy_rules": [],
                    "ikepolicy": {
                        "ike_version": "v2",
                        "authentication_algorithm": "sha2-256",
                        "encryption_algorithm": "aes-128",
                        "dh_group": "group15",
                        "authentication_method": "pre-share",
                        "lifetime_seconds": 86400,
                        "local_id_type": "ip",
                        "local_id": "215.***.***.55",
                        "peer_id_type": "ip",
                        "peer_id": "2.***.***.2",
                        "dpd": {
                            "interval": 30,
                            "timeout": 15,
                            "msg": "seq-hash-notify"
                        }
                    },
                    "ipsecpolicy": {
                        "authentication_algorithm": "sha2-256",
                        "encryption_algorithm": "aes-128",
                        "pfs": "group15",
                        "transform_protocol": "esp",
                        "lifetime_seconds": 3600,
                        "encapsulation_mode": "tunnel"
                    },
                    "created_at": "2025-02-21T03:53:23.226Z",
                    "updated_at": "2025-02-21T03:53:23.226Z",
                    "enterprise_project_id": "0",
                    "ha_role": "master",
                    "tags": [],
                    "policy_rules_v6": []
                }
            ],
            "request_id": "3c53db019753c69323303c198af58a85"
        }
      2. 批量创建策略模式连接的响应。
        {
            "vpn_connections": [
                {
                    "id": "db06a7cb-e3b5-4c8c-b682-40ed54e8eb54",
                    "name": "vpn-ed37",
                    "vgw_id": "8030f6d6-32a8-4d20-a7f8-50a7a826e2f8",
                    "vgw_ip": "1fb97767-d780-4d8b-83bb-6f878f662005",
                    "style": "POLICY",
                    "cgw_id": "12f3577a-cbd8-4602-b68c-ecbf792fcec5",
                    "peer_subnets": [
                        "192.168.2.0/24"
                    ],
                    "tunnel_local_address": "169.254.44.197/30",
                    "tunnel_peer_address": "169.254.44.198/30",
                    "policy_rules": [
                        {
                            "rule_index": 1,
                            "source": "192.168.37.0/24",
                            "destination": [
                                "192.168.2.0/24"
                            ]
                        }
                    ],
                    "ikepolicy": {
                        "ike_version": "v2",
                        "authentication_algorithm": "sha2-256",
                        "encryption_algorithm": "aes-128",
                        "dh_group": "group15",
                        "authentication_method": "pre-share",
                        "lifetime_seconds": 86400,
                        "local_id_type": "ip",
                        "local_id": "215.***.***.55",
                        "peer_id_type": "ip",
                        "peer_id": "2.***.***.2",
                        "dpd": {
                            "interval": 30,
                            "timeout": 15,
                            "msg": "seq-hash-notify"
                        }
                    },
                    "ipsecpolicy": {
                        "authentication_algorithm": "sha2-256",
                        "encryption_algorithm": "aes-128",
                        "pfs": "group15",
                        "transform_protocol": "esp",
                        "lifetime_seconds": 3600,
                        "encapsulation_mode": "tunnel"
                    },
                    "created_at": "2025-02-21T03:59:50.341Z",
                    "updated_at": "2025-02-21T03:59:50.341Z",
                    "enterprise_project_id": "0",
                    "ha_role": "master",
                    "tags": [],
                    "policy_rules_v6": []
                },
                {
                    "id": "9f5220fd-f674-420c-9df7-6b6420a3ae99",
                    "name": "vpn-d0c2",
                    "vgw_id": "8030f6d6-32a8-4d20-a7f8-50a7a826e2f8",
                    "vgw_ip": "0d0f4af1-42b9-41eb-97b9-b4d41a0bf9c4",
                    "style": "POLICY",
                    "cgw_id": "12f3577a-cbd8-4602-b68c-ecbf792fcec5",
                    "peer_subnets": [
                        "192.168.2.0/24"
                    ],
                    "tunnel_local_address": "169.254.192.61/30",
                    "tunnel_peer_address": "169.254.192.62/30",
                    "policy_rules": [
                        {
                            "rule_index": 1,
                            "source": "192.168.37.0/24",
                            "destination": [
                                "192.168.2.0/24"
                            ]
                        }
                    ],
                    "ikepolicy": {
                        "ike_version": "v2",
                        "authentication_algorithm": "sha2-256",
                        "encryption_algorithm": "aes-128",
                        "dh_group": "group15",
                        "authentication_method": "pre-share",
                        "lifetime_seconds": 86400,
                        "local_id_type": "ip",
                        "local_id": "10.***.***.173",
                        "peer_id_type": "ip",
                        "peer_id": "2.***.***.2",
                        "dpd": {
                            "interval": 30,
                            "timeout": 15,
                            "msg": "seq-hash-notify"
                        }
                    },
                    "ipsecpolicy": {
                        "authentication_algorithm": "sha2-256",
                        "encryption_algorithm": "aes-128",
                        "pfs": "group15",
                        "transform_protocol": "esp",
                        "lifetime_seconds": 3600,
                        "encapsulation_mode": "tunnel"
                    },
                    "created_at": "2025-02-21T03:59:50.651Z",
                    "updated_at": "2025-02-21T03:59:50.651Z",
                    "enterprise_project_id": "0",
                    "ha_role": "master",
                    "tags": [],
                    "policy_rules_v6": []
                }
            ],
            "request_id": "81237dad5e1338b1818cd6582781b610"
        }
      3. 批量创建bgp路由模式连接的响应。
        {
            "vpn_connections": [
                {
                    "id": "5ddf5d02-c746-4075-be4b-95e9213e1c3c",
                    "name": "vpn-1655",
                    "vgw_id": "8030f6d6-32a8-4d20-a7f8-50a7a826e2f8",
                    "vgw_ip": "0d0f4af1-42b9-41eb-97b9-b4d41a0bf9c4",
                    "style": "BGP",
                    "cgw_id": "12f3577a-cbd8-4602-b68c-ecbf792fcec5",
                    "peer_subnets": [
                        "192.168.2.0/24"
                    ],
                    "tunnel_local_address": "169.254.56.225/30",
                    "tunnel_peer_address": "169.254.56.226/30",
                    "enable_hub": false,
                    "policy_rules": [],
                    "ikepolicy": {
                        "ike_version": "v2",
                        "authentication_algorithm": "sha2-512",
                        "encryption_algorithm": "aes-256",
                        "dh_group": "group16",
                        "authentication_method": "pre-share",
                        "lifetime_seconds": 172800,
                        "local_id_type": "fqdn",
                        "local_id": "123***",
                        "peer_id_type": "fqdn",
                        "peer_id": "456***",
                        "dpd": {
                            "interval": 60,
                            "timeout": 30,
                            "msg": "seq-notify-hash"
                        }
                    },
                    "ipsecpolicy": {
                        "authentication_algorithm": "sha2-512",
                        "encryption_algorithm": "aes-256",
                        "pfs": "group16",
                        "transform_protocol": "esp",
                        "lifetime_seconds": 7200,
                        "encapsulation_mode": "tunnel"
                    },
                    "created_at": "2025-02-21T06:50:25.238Z",
                    "updated_at": "2025-02-21T06:50:25.238Z",
                    "enterprise_project_id": "0",
                    "ha_role": "master",
                    "tags": [],
                    "policy_rules_v6": []
                },
                {
                    "id": "bb3632dd-f517-4e94-96b7-977c70d28966",
                    "name": "vpn-1341",
                    "vgw_id": "8030f6d6-32a8-4d20-a7f8-50a7a826e2f8",
                    "vgw_ip": "1fb97767-d780-4d8b-83bb-6f878f662005",
                    "style": "BGP",
                    "cgw_id": "12f3577a-cbd8-4602-b68c-ecbf792fcec5",
                    "peer_subnets": [
                        "192.168.2.0/24"
                    ],
                    "tunnel_local_address": "169.254.56.225/30",
                    "tunnel_peer_address": "169.254.56.226/30",
                    "enable_hub": false,
                    "policy_rules": [],
                    "ikepolicy": {
                        "ike_version": "v2",
                        "authentication_algorithm": "sha2-512",
                        "encryption_algorithm": "aes-256",
                        "dh_group": "group16",
                        "authentication_method": "pre-share",
                        "lifetime_seconds": 172800,
                        "local_id_type": "fqdn",
                        "local_id": "123***",
                        "peer_id_type": "fqdn",
                        "peer_id": "456***",
                        "dpd": {
                            "interval": 60,
                            "timeout": 30,
                            "msg": "seq-notify-hash"
                        }
                    },
                    "ipsecpolicy": {
                        "authentication_algorithm": "sha2-512",
                        "encryption_algorithm": "aes-256",
                        "pfs": "group16",
                        "transform_protocol": "esp",
                        "lifetime_seconds": 7200,
                        "encapsulation_mode": "tunnel"
                    },
                    "created_at": "2025-02-21T06:50:25.5Z",
                    "updated_at": "2025-02-21T06:50:25.5Z",
                    "enterprise_project_id": "0",
                    "ha_role": "master",
                    "tags": [],
                    "policy_rules_v6": []
                }
            ],
            "request_id": "938ea2bba48836a429c741bd6f7627a4"
        }

状态码

请参见状态码

相关文档