获取链路信息 - ListDataLinks
功能介绍
功能介绍:获取链路信息。按时间范围从 ES 查询数据流转日志,构建 DB→ECS→ELB/APIG→ADG→外部 的节点与连线;start_time、end_time 必填,egress_type 为空时不过滤出口类型,无匹配数据时返回空的 nodes、links。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
POST /v1/{project_id}/logtrace/data-links
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID。可参考获取项目ID获取。 约束限制: 不涉及 取值范围: 以IAM服务接口返回值为准,长度为32个字符,满足正则匹配"^[a-z0-9]{32}$" 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| dbss_instance_id | 否 | String | 参数解释: DBSS实例ID,用于按实例过滤 DBSS 数据流转日志 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| oem_instance_id | 否 | String | 参数解释: ADG(OEM)实例ID 约束限制: 当前版本未参与查询过滤 取值范围: 不涉及 默认取值: 不涉及 |
| start_time | 是 | Long | 参数解释: 开始时间,毫秒级Unix时间戳,表示查询时间范围的起始时间点 约束限制: 必填,需小于等于 end_time 取值范围: 毫秒级Unix时间戳 默认取值: 不涉及 |
| end_time | 是 | Long | 参数解释: 结束时间,毫秒级Unix时间戳,表示查询时间范围的结束时间点 约束限制: 必填,需大于等于 start_time 取值范围: 毫秒级Unix时间戳 默认取值: 不涉及 |
| db_name | 否 | String | 参数解释: 数据库名称,用于过滤 DBSS 数据流转日志 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| ecs_name | 否 | String | 参数解释: ECS实例名称,用于过滤 ECS 节点 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| egress_type | 否 | String | 参数解释: 出口类型,用于过滤出口节点类型 约束限制: 为空时不过滤出口类型 取值范围: 默认取值: 不涉及 |
| internet_ip | 否 | String | 参数解释: 公网IP地址,用于过滤 ADG 数据流转日志 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| labels | 否 | Array of strings | 参数解释: 标签列表,数组中的每个元素为一个标签名称(String类型),用于按标签过滤日志追踪链路 约束限制: 支持标签中文名、英文名或枚举名,如"手机号"、"Phone Number"、"PHONE_NUMBER" 取值范围: 敏感数据标签名称 默认取值: 不涉及 |
| sensitive_level | 否 | Integer | 参数解释: 敏感级别,过滤敏感等级不低于该值的记录 约束限制: 不涉及 取值范围: 1~10 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| nodes | Array of LogTraceNode objects | 参数解释: 链路节点信息列表,数组元素为LogTraceNode对象,包含节点ID、名称、类型、IP、加密状态与敏感信息列表 取值范围: 不涉及 |
| links | Array of LogTraceLink objects | 参数解释: 链路连接信息列表,数组元素为LogTraceLink对象,包含源节点ID、目标节点ID、访问次数等 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 节点ID 取值范围: 不涉及 |
| name | String | 参数解释: 节点名称 取值范围: 不涉及 |
| node_type | String | 参数解释: 节点类型 取值范围: |
| fixed_ip | String | 参数解释: 固定IP 取值范围: 不涉及 |
| fixedIp | String | 参数解释: 固定IP(适配老版前端字段) 取值范围: 不涉及 |
| floating_ip | String | 参数解释: 浮动IP 取值范围: 不涉及 |
| floatingIp | String | 参数解释: 浮动IP(适配老版前端字段) 取值范围: 不涉及 |
| encrypt_status | String | 参数解释: 加密状态 取值范围: |
| sensitive_infos | Array of LogTraceSensitiveInfo objects | 参数解释: 敏感信息列表,数组元素为SensitiveInfo对象 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| label_name | String | 参数解释: 标签名称 取值范围: 不涉及 |
| sensitive_level | Integer | 参数解释: 敏感级别 取值范围: 1~10 |
请求示例
无
响应示例
状态码:200
{
"nodes" : [ {
"id" : "node-001",
"name" : "dbss-instance-01",
"node_type" : "DB",
"fixed_ip" : "192.168.1.100",
"fixedIp" : "192.168.1.100",
"floating_ip" : "192.168.1.101",
"floatingIp" : "192.168.1.101",
"encrypt_status" : "UNKNOWN",
"sensitive_infos" : [ {
"label_name" : "手机号",
"sensitive_level" : 3
} ]
} ],
"links" : [ {
"source_node_id" : "node-001",
"target_node_id" : "node-002",
"access_times" : 10,
"ssl_access_times" : 5,
"encrypt_status" : "UNKNOWN"
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询成功 |
错误码
请参见错误码。