# 获取链路信息 - ShowQueryLinks
#### 功能介绍
该接口用于查询数据链路信息。支持通过多种过滤条件筛选链路，返回链路的详细信息，帮助用户分析数据流动情况和排查问题。参数包括数据库名称、实例ID、ECS名称、出站类型、结束时间、公网IP、标签、ADG实例ID、敏感级别和开始时间等。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dsc/dsc_02_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dsc/dsc_02_0031.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
POST /v1/{project_id}/logtrace/data-links
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述             |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID，用于标识具体的项目 |
   
#### 请求参数
表2请求Body参数 
| 参数               | 是否必选 | 参数类型             | 描述          |
|:---|:---|:---|:---|
| db_name          | 否    | String           | 数据库名称       |
| dbss_instance_id | 否    | String           | 数据库安全服务实例ID |
| ecs_name         | 否    | String           | ECS实例名称     |
| egress_type      | 否    | String           | 出站类型        |
| end_time         | 否    | Long             | 结束时间        |
| internet_ip      | 否    | String           | 公网IP地址      |
| labels           | 否    | Array of strings | 标签列表        |
| oem_instance_id  | 否    | String           | ADG实例ID     |
| sensitive_level  | 否    | Integer          | 敏感级别        |
| start_time       | 否    | Long             | 开始时间        |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数    | 参数类型                                                                    | 描述     |
|:---|:---|:---|
| links | Array of [LogTraceLink] objects | 连接信息列表 |
| nodes | Array of [LogTraceNode] objects | 节点信息列表 |
   
 表4LogTraceLink 
| 参数               | 参数类型    | 描述      |
|:---|:---|:---|
| access_times     | Integer | 访问次数    |
| encrypt_status   | String  | 加密状态    |
| source_node_id   | String  | 源节点ID   |
| ssl_access_times | Integer | SSL访问次数 |
| target_node_id   | String  | 目标节点ID  |
   
 表5LogTraceNode 
| 参数              | 参数类型                                                                      | 描述     |
|:---|:---|:---|
| encrypt_status  | String                                                                    | 加密状态   |
| fixed_ip        | String                                                                    | 固定IP地址 |
| floating_ip     | String                                                                    | 浮动IP地址 |
| id              | String                                                                    | 节点ID   |
| name            | String                                                                    | 节点名称   |
| node_type       | String                                                                    | 节点类型   |
| sensitive_infos | Array of [SensitiveInfo] objects | 敏感信息列表 |
   
 表6SensitiveInfo 
| 参数              | 参数类型    | 描述   |
|:---|:---|:---|
| label_name      | String  | 标签名称 |
| sensitive_level | Integer | 敏感级别 |
   
**状态码：201**
Created
#### 请求示例
```
POST /v1/{project_id}/logtrace/data-links
{
  "db_name" : "string",
  "dbss_instance_id" : "string",
  "ecs_name" : "string",
  "egress_type" : "string",
  "end_time" : 0,
  "internet_ip" : "string",
  "labels" : [ "string" ],
  "oem_instance_id" : "string",
  "sensitive_level" : 0,
  "start_time" : 0
}
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述             |
|:---|:---|
| 200 | OK             |
| 201 | Created        |
| 401 | 未授权，用户未登录或令牌无效 |
| 403 | 无权限访问该资源       |
| 404 | 指定的项目不存在       |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。