更新时间:2025-08-30 GMT+08:00
分享

查询流程实例的详情

功能介绍

查询流程实例的详情

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/workspaces/{workspace_id}/soc/workflows/instances/{instance_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

workspace_id

String

参数解释:

工作空间ID

取值范围:

不涉及

instance_id

String

参数解释:

流程实例的ID

约束限制:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

show_topology

Boolean

参数解释:

是否查询流程拓扑图的信息

  • true 查询

  • false 不查询

约束限制:

不涉及

取值范围:

  • true

  • false

默认值:

false

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。获取用户Token

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

content-type

String

参数解释:

内容类型

  • application/json;charset=UTF-8 普通API请求的类型

约束限制:

不涉及

取值范围:

  • application/json;charset=UTF-8

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

id

String

参数解释:

流程实例的ID

约束限制:

不涉及

name

String

参数解释:

流程实例的名字

约束限制:

不涉及

workflow

workflow object

流程对象

dataclass

dataclass object

数据类对象

playbook

playbook object

剧本对象

trigger_type

String

参数解释:

触发方式

取值范围:

  • DEBUG 调试触发

  • TIMER 定时触发

  • EVENT 事件触发

  • MANUAL 手动触发

status

String

参数解释:

流程实例的状态

取值范围:

  • RUNNING 运行中

  • FAILED 运行失败

  • FINISHED 运行结束

  • RETRYING 重试中

  • TERMINATING 终止中

  • TERMINATED 已终止

start_time

String

参数解释:

开始时间

约束限制:

不涉及

end_time

String

参数解释:

结束时间

约束限制:

不涉及

retry_count

Integer

参数解释:

流程实例重试次数

约束限制:

不涉及

defense_id

String

参数解释:

防线ID

约束限制:

不涉及

dataobject_id

String

参数解释:

dataobject的ID

约束限制:

不涉及

topology

WorkflowInstanceTopology object

参数解释:

流程实例拓扑图信息

约束限制:

不涉及

表5 workflow

参数

参数类型

描述

id

String

参数解释:

流程的ID

约束限制:

不涉及

name

String

参数解释:

流程的中文名字

约束限制:

不涉及

name_en

String

参数解释:

流程的英文名字

约束限制:

不涉及

version

String

参数解释:

流程的版本

约束限制:

不涉及

表6 dataclass

参数

参数类型

描述

en_name

String

参数解释:

数据类的英文名字

约束限制:

不涉及

id

String

参数解释:

数据类的ID

约束限制:

不涉及

name

String

参数解释:

数据类的中文名字

约束限制:

不涉及

表7 playbook

参数

参数类型

描述

en_name

String

参数解释:

剧本英文名字

约束限制:

不涉及

id

String

参数解释:

剧本的ID

约束限制:

不涉及

name

String

参数解释:

剧本的名字

约束限制:

不涉及

表8 WorkflowInstanceTopology

参数

参数类型

描述

audit_logs

Array of TopologyNodeInfo objects

参数解释:

拓扑图节点信息

约束限制:

不涉及

表9 TopologyNodeInfo

参数

参数类型

描述

instance_type

String

参数解释:

流程图拓扑图的节点实例类型

取值范围:

  • TASK

action_id

String

参数解释:

流程拓扑图的节点ID

取值范围:

不涉及

action_name

String

参数解释:

流程拓扑图的节点名称

取值范围:

不涉及

start_time

String

参数解释:

流程图拓扑图的节点开始时间

取值范围:

  • 不涉及

end_time

String

参数解释:

流程图拓扑图的节点结束时间

取值范围:

  • 不涉及

error_msg

String

参数解释:

流程图拓扑图的节点错误信息

取值范围:

  • 不涉及

input

String

参数解释:

流程图拓扑图的节点输入信息

取值范围:

  • 不涉及

output

String

参数解释:

流程图拓扑图的节点输出信息

取值范围:

  • 不涉及

parent_instance_id

String

参数解释:

流程图拓扑图的父实例ID

取值范围:

  • 不涉及

status

String

参数解释:

流程图拓扑图的节点的状态

取值范围:

  • RUNNING 运行中

  • FAILED 运行失败

  • FINISHED 运行结束

succeed

Boolean

参数解释:

流程图拓扑图的节点是否成功

取值范围:

  • true 成功

  • false 失败

状态码:400

表10 响应Body参数

参数

参数类型

描述

code

String

参数解释:

错误码

取值范围:

不涉及

message

String

参数解释:

错误描述

取值范围:

不涉及

请求示例

响应示例

状态码:200

Response of get workflow instance

{
  "dataclass" : {
    "id" : "e410ae50-43fa-343e-807a-a2a9edb8018e",
    "name" : "Alert"
  },
  "dataobject_id" : "2462e8c3-e393-4af9-93b6-fe424c0b4e39",
  "defense_id" : "",
  "end_time" : "2025-07-18T15:11:04.577Z+0800",
  "id" : "8eed56de-7aaf-4732-baaf-46c1bb11dc8f",
  "name" : "ZFGJZDGB-20250718151103",
  "playbook" : {
    "id" : "3e966553-f53d-3d87-835e-7697e353876a",
    "name" : "Automatic closing of repeated alerts"
  },
  "retry_count" : 0,
  "start_time" : "2025-07-18T15:11:03.000Z+0800",
  "status" : "FINISHED",
  "trigger_type" : "EVENT",
  "workflow" : {
    "id" : "4a6fe02f-b4b4-3b5f-8a11-6f22229e18db",
    "name" : "Automatic closing of repeated alerts",
    "version" : "v1",
    "version_id" : "9f436a38-5c82-312b-aaba-b91a48e99086"
  }
}

状态码

状态码

描述

200

Response of get workflow instance

400

Error response

错误码

请参见错误码

相关文档