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

查询VPN连接监控 - QueryVPNConnectionMonitor

功能介绍

根据VPN连接监控的ID,查询指定的VPN连接监控。

调用方法

请参见如何调用API

授权信息

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

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

vpn:connectionMonitors:get

read

vpnConnections

-

-

URI

GET /v5/{project_id}/connection-monitors/{connection_monitor_id}

表1 参数说明

名称

类型

是否必选

说明

project_id

String

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

connection_monitor_id

String

VPN连接监控的ID。

请求消息

  • 请求参数

    无。

  • 请求样例
    GET https://{Endpoint}/v5/{project_id}/connection-monitors/{connection_monitor_id}

响应消息

  • 响应参数

    返回状态码为 200: 查询成功。

    表2 响应Body参数列表

    名称

    类型

    描述

    connection_monitor

    ConnectionMonitorInfo object

    connection_monitor对象。

    request_id

    String

    请求ID。

    表3 ConnectionMonitorInfo

    名称

    类型

    描述

    id

    String

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

    status

    String

    • 功能说明:VPN连接监控状态。
    • 取值范围:

      ACTIVE:正常。

      PENDING_CREATE:创建中。

      PENDING_DELETE:删除中。

    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",
            "status": "ACTIVE",
            "vpn_connection_id": "cae286f2-demo-a8df-va86-e22416ca1220",
            "type": "gateway",
            "source_ip": "88.***.***.60",
            "destination_ip": "88.***.***.32",
            "proto_type": "icmp"
        },
        "request_id": "6d212bc0-ecb1-457b-977b-5e815fce658d"
    }

状态码

请参见状态码