# 查询VPN连接 - QueryVPNConnection #### 功能介绍 根据连接ID，查询指定的VPN连接的参数。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-vpn/vpn_api_0008.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-vpn/vpn_api_0044.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | vpn:vpnConnections:get | read | vpnGateways | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2) - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2) | - | - vpc:publicIps:get - vpc:publicIps:list - vpc:bandwidths:list - er:instances:list - er:instances:get - vpc:vpcs:list - vpc:vpcs:get - vpc:subnets:get | | vpn:vpnConnections:get | read | customerGateways | [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2) | - | - vpc:publicIps:get - vpc:publicIps:list - vpc:bandwidths:list - er:instances:list - er:instances:get - vpc:vpcs:list - vpc:vpcs:get - vpc:subnets:get | | vpn:vpnConnections:get | read | vpnConnections | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2) - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2) | - | - vpc:publicIps:get - vpc:publicIps:list - vpc:bandwidths:list - er:instances:list - er:instances:get - vpc:vpcs:list - vpc:vpcs:get - vpc:subnets:get | #### URI GET /v5/{project_id}/vpn-connection/{vpn_connection_id} 表1参数说明 | 名称 | 类型 | 是否必选 | 说明 | |:---|:---|:---|:---| | project_id | String | 是 | 项目ID，可以通过[获取项目ID](https://support.huaweicloud.com/api-vpn/vpn_api_0051.html)获取项目ID。 | | vpn_connection_id | String | 是 | VPN连接ID。 | #### 请求消息 - 请求参数 无。 - 请求样例 ``` GET https://{Endpoint}/v5/{project_id}/vpn-connection/{vpn_connection_id} ``` #### 响应消息 - 响应参数 返回状态码为 200: successful operation。 表2响应Body参数列表 | 名称 | 类型 | 描述 | |:---|:---|:---| | vpn_connection | [ResponseVpnConnection] object | vpn_connection对象。 | | request_id | String | 请求ID。 | 表3ResponseVpnConnection | 名称 | 类型 | 描述 | |:---|:---|:---| | id | String | - 功能说明：VPN连接ID。 - 格式：36位UUID。 | | name | String | - 功能说明：VPN连接名称。 - 取值范围：1-64个字符，支持数字、英文字母、中文（\\u4e00 - \\u9fa5）、_（下划线）、-（中划线）、.（点）。 | | status | String | - 功能说明：VPN连接状态。 - 取值范围： ERROR：异常。 ACTIVE：正常。 DOWN：未连接。 PENDING_CREATE：创建中。 PENDING_UPDATE：更新中。 PENDING_DELETE：删除中。 FREEZED：冻结中。 UNKNOWN：未知。 | | 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。 | | enable_hub | Boolean | - 功能说明：开启分支互联。仅当style为BGP时返回。 - 取值范围：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:ss.SSSZ。* | | updated_at | String | - 最后一次更新时间。 - UTC时间格式：*yyyy-MM-ddTHH:mm:ss.SSSZ。* | | enterprise_project_id | String | - 功能说明：企业项目ID。 - 格式：36位UUID。与vgw_id所标识VPN网关的企业项目ID一致。 | | connection_monitor_id | String | - 功能说明：VPN连接监控ID。仅当VPN连接下创建有连接监控时返回。 - 格式：36位UUID。 | | ha_role | String | - 功能说明：主备模式VPN网关下的连接时，'master'表示主连接，'slave'表示备连接。双活模式下的连接ha_role都是'master'。 - 默认值：master。 | | psk | String | 功能说明：预共享密钥。 | | tags | Array of [VpnResourceTag] objects | 标签列表。 | | bgp_peer | [BgpPeer] object | BGP邻居信息。 | 表4PolicyRule | 名称 | 类型 | 描述 | |:---|:---|:---| | rule_index | Integer | - 功能说明：规则ID。 - 取值范围：0-50。 - 注：该字段已经废弃，但仍然保留兼容性支持，建议不要使用该字段。 | | source | String | 源地址网段。 | | destination | Array of String | 目的地址网段。单个IPv4网段格式示例：192.168.52.0/24。单个IPv6网段格式示例：16af:cacc:1097::/48。每个PolicyRule最多返回50个。 | 表5IkePolicy | 名称 | 类型 | 描述 | |:---|:---|:---| | 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：IP类型。 | | local_id | String | 本端ID。当local_id_type为ip时返回创建或更新VPN连接时指定的本端ID，如果未指定则返回VPN连接所使用的VPN网关IP；当local_id_type为fqdn时返回创建或更新VPN连接时指定的本端ID。 当VPN网关flavor为GM时不返回。 | | peer_id_type | String | - 功能说明：对端ID类型，当VPN网关flavor为GM时不返回。 - 取值范围： - ip：IP类型 | | peer_id | String | 对端ID。当peer_id_type为ip时返回创建或更新VPN连接时指定的对端ID，如果未指定则返回对端网关的IP；当peer_id_type为fqdn时返回创建或更新VPN连接时指定的对端ID。 当VPN网关flavor为GM时不返回。 | | dpd | [Dpd] object | 对等体存活检测对象。 | 表6Dpd | 名称 | 类型 | 描述 | |:---|:---|:---| | timeout | Integer | - 功能说明：对等体存活检测报文重传间隔。 - 取值范围：2-60，单位：秒。 | | interval | Integer | - 功能说明：对等体存活检测空闲时间。 - 取值范围：10-3600，单位：秒。 | | msg | String | - 功能说明：对等体存活检测报文格式。 - 取值范围： seq-hash-notify：指定DPD报文中的载荷顺序是hash-notify。 seq-notify-hash：指定DPD报文中的载荷顺序是notify-hash。 | 表7IpsecPolicy | 名称 | 类型 | 描述 | |:---|:---|:---| | 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：隧道模式。 | 表8VpnResourceTag | 名称 | 类型 | 描述 | |:---|:---|:---| | key | String | - 功能说明：标签的键。 - 取值范围：1-128个字符，支持数字、英文字母、中文、西班牙语、葡语、空格，以及以下字符：_.:=+-@。 | | value | String | - 功能说明：标签的值。 - 取值范围：0-255个字符，支持数字、英文字母、中文、西班牙语、葡语、空格，以及以下字符：_.:=+-@。 | 表9BgpPeer | 名称 | 类型 | 描述 | |:---|:---|:---| | peer_ip_address | String | BGP邻居地址。 | | peer_asn | Integer | BGP邻居的BGP自治域编号。 | | state | String | 邻居状态。 | | state_duration | String | 连接持续时间。 | | num_received_routes | Integer | 已收到的路由数。 | | num_message_received | Integer | 已收到的消息数。 | | num_message_sent | Integer | 已发送的消息数。 | - 响应样例 ``` { "vpn_connection": { "id": "98c5af8a-demo-a8df-va86-ae2280a6f4c3", "name": "vpn-1655", "status": "DOWN", "vgw_id": "b32d91a4-demo-a8df-va86-e907174eb11d", "vgw_ip": "0c464dad-demo-a8df-va86-c22bb0eb0bde", "style": "POLICY", "cgw_id": "5247ae10-demo-a8df-va86-dd36659a7f5d", "peer_subnets": ["192.168.0.0/24"], "tunnel_local_address": "169.254.56.225/30", "tunnel_peer_address": "169.254.56.226/30", "policy_rules": [{ "rule_index": 1, "source": "10.0.0.0/24", "destination": [ "192.168.0.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.***.***.134", "peer_id_type": "ip", "peer_id": "88.***.***.164", "dpd": { "timeout": 15, "interval": 30, "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-06-26T13:41:34.626Z", "updated_at": "2025-06-26T13:41:34.626Z", "enterprise_project_id": "0", "ha_role":"master", "tags": [], "policy_rules_v6": [], "bgp_peer": { "peer_ip_address": "169.254.173.1", "peer_asn": 64516, "state": "established", "state_duration": "3d01h34m24s", "num_received_routes": 5, "num_message_received": 15541, "num_message_sent": 15516 }, }, "request_id": "f91082d4-6d49-479c-ad1d-4e552a9f5cae" } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-vpn/vpn_api_0052.html)。