文档首页/ 虚拟专用网络 VPN/ API参考/ API/ 站点入云VPN API/ VPN连接监控/ 创建VPN连接监控 - CreateVPNConnectionMonitor
更新时间:2026-04-24 GMT+08:00

创建VPN连接监控 - CreateVPNConnectionMonitor

功能介绍

创建VPN连接监控。连接监控是网关之间的健康检查,添加健康检查可以配置VPN网关、向对端网关发送监测报文,统计链路往返时延和丢包率,用于检测VPN连接的质量。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

vpn:connectionMonitors:create

write

vpnConnections

-

-

URI

POST /v5/{project_id}/connection-monitors

表1 参数说明

名称

类型

是否必选

说明

project_id

String

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

请求消息

  • 请求参数
    表2 请求参数

    名称

    类型

    是否必选

    描述

    connection_monitor

    CreateConnectionMonitorRequestBodyContent object

    connection_monitor对象。

    表3 CreateConnectionMonitorRequestBodyContent

    名称

    类型

    是否必选

    描述

    vpn_connection_id

    String

    VPN连接监控对应的VPN连接ID。

    可以通过查询VPN连接列表查看VPN连接ID。

  • 请求样例
    POST https://{Endpoint}/v5/{project_id}/connection-monitors
    
    {
        "connection_monitor": {
            "vpn_connection_id": "cae286f2-demo-a8df-va86-e22416ca1220"
        }
    }

响应消息

  • 响应参数

    返回状态码为 201: successful operation。

    表4 响应Body参数列表

    名称

    类型

    描述

    connection_monitor

    ConnectionMonitorInfo object

    connection_monitor对象。

    request_id

    String

    请求ID。

    表5 ConnectionMonitorInfo

    名称

    类型

    描述

    id

    String

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

    vpn_connection_id

    String

    • 功能说明:VPN连接监控对应的VPN连接ID。
    • 格式:36位UUID。

    type

    String

    • 功能说明:监控类型。
    • 取值范围:

      gateway:VPN网关。

    source_ip

    String

    VPN连接监控的源地址。

    destination_ip

    String

    VPN连接监控的目的地址。

    proto_type

    String

    • 功能说明:nqa使用的协议类型。
    • 取值范围:

      icmp:ICMP协议。

  • 响应样例
    {
        "connection_monitor":{
            "id":"76f64229-demo-a8df-va86-3907e2815b6d",
            "vpn_connection_id":"cae286f2-demo-a8df-va86-e22416ca1220",
            "type":"gateway",
            "source_ip":"88.***.***.60",
            "destination_ip":"88.***.***.32",
            "proto_type":"icmp"
        },
        "request_id": "bd37d16d-387c-41ab-a180-01b649f73590"
    }

状态码

请参见状态码