# 查询VPN连接网段协商信息
#### 功能介绍
根据连接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:listIpsecSa | read | vpnConnections | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2)  - [g:ResourceTag/\<tag-key\>](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2)   | -  | -      |
   
#### URI
GET /v5/{project_id}/vpn-connection/{vpn_connection_id}/ipsec-sa
表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}/ipsec-sa
  ```
  
 
#### 响应消息
- 响应参数 返回状态码为 200: successful operation。
  表2响应Body参数列表 
  | 名称         | 类型                                                                           | 描述        |
  |:---|:---|:---|
  | request_id | String                                                                       | 请求ID。     |
  | sa_infos   | Array of [SaInfo] objects | SaInfo对象。 |
     
   表3SaInfo 
  | 名称             | 类型      | 描述                                                                                                                                                                                                                                                                                                     |
  |:---|:---|:---|
  | 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"
  }
  ```
  
 
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-vpn/vpn_api_0052.html)。