查询VPN连接网段协商信息

功能介绍

根据连接ID，查询指定的VPN连接网段协商信息。

调用方法

请参见如何调用API。

授权信息

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

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

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
vpn:vpnConnections:listIpsecSa	read	vpnConnections	g:EnterpriseProjectId g:ResourceTag/<tag-key>	-	-

URI

GET /v5/{project_id}/vpn-connection/{vpn_connection_id}/ipsec-sa

表1 参数说明
名称	类型	是否必选	说明
project_id	String	是	项目ID，可以通过获取项目ID获取项目ID。
vpn_connection_id	String	是	VPN连接ID。

请求消息

请求参数
 无。

请求样例

GET https://{Endpoint}/v5/{project_id}/vpn-connection/{vpn_connection_id}/ipsec-sa

响应消息

响应参数

返回状态码为 200: successful operation。

表2 响应Body参数列表
名称	类型	描述
request_id	String	请求ID。
sa_infos	Array of SaInfo objects	SaInfo对象。

表3 SaInfo
名称	类型	描述
id	String	网段协商ID。
source_ip_cidr	String	源IP网段。
dest_ip_cidr	String	目的IP网段。
packets_sent	Integer	发送包。
packets_recv	Integer	接收包。
traffic_sent	Integer	发送流量。单位：Byte。
traffic_recv	Integer	接收流量。单位：Byte。
collected_at	String	数据收集时间。 UTC时间格式：yyyy-MM-ddTHH:mm:ss.SSSZ。

响应样例

{
    "sa_infos": [
        {
            "id": "4f43df63-9263-4895-ba15-e9aae9c9fa68",
            "source_ip_cidr": "0.0.0.0/0",
            "dest_ip_cidr": "0.0.0.0/0",
            "packets_sent": 15516,
            "packets_recv": 15513,
            "traffic_sent": 1295454,
            "traffic_recv": 1294979,
            "collected_at": "2026-04-09T03:28:33.351Z"
        }
    ],
    "request_id": "61593611ee016546ba0a61992083d80b"
}