查看工作流作业节点¶

查看一个作业节点的运行输入、输出和状态。

GET https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps/{workflow_id}/executions/{execution_id}/nodes/{node_key}

调用前准备¶

先查看工作流作业结果，从作业步骤中选择要查看的节点。准备具有工作流读取权限的个人访问令牌和目标工作区 ID。

路径参数¶

将 $AI_STUDIO_API_KEY、$WORKSPACE_ID、$WORKFLOW_ID、$EXECUTION_ID 和 $NODE_KEY 替换为实际值。

调用示例

curl "https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps/$WORKFLOW_ID/executions/$EXECUTION_ID/nodes/$NODE_KEY" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

参数	类型	是否必填	说明
`workflow_id`	string	是	工作流 ID。
`execution_id`	string	是	作业 ID。
`node_key`	string	是	作业结果 `data.result.job_summary.steps[].node_key`，例如 `root.cleaned`；不能只填写 `cleaned`。

成功响应¶

成功时返回 200 和节点定义、运行快照。

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "node": {
      "node_key": "extract",
      "name": "extract",
      "node_type": "extract"
    },
    "run": {
      "status": "COMPLETED",
      "duration_ms": 1250
    }
  }
}

字段说明

节点定义

下面表格展开响应示例中 data 下的 node 对象；每一行是该对象的一个字段。

字段	类型	说明
`flow_id`	string	节点所属流程 ID。
`name`	string	节点名称。
`node_key`	string	DSL 节点键。
`node_type`	string	节点类型。
`display_name`	string	节点显示名称。
`workitem_id`	string	工作项标识；有值时返回。
`node_execution_id`	string	节点执行标识；有值时返回。

运行信息

下面表格展开响应示例中 data 下的 run 对象；每一行是该对象的一个字段。

字段	类型	说明
`status`	string	节点当前或最终状态。
`started_at`	string	节点运行开始时间；未产生时省略。
`ended_at`	string	节点运行结束时间；未产生时省略。
`duration_ms`	integer	节点运行耗时，单位为毫秒；未产生时省略。
`error`	string	节点执行错误；有错误时返回。
`runtime_input`	object 或 null	节点运行时输入快照。
`runtime_output`	object 或 null	节点运行时输出快照。
`runtime_vars`	object 或 null	节点运行时变量快照。
`config`	object 或 null	节点运行配置快照。
`metrics`	object	节点指标；服务端提供时返回。
`developer_logs`	object	开发日志；服务端提供时返回。

错误响应¶

响应示例

{
  "code": "ErrNotFound",
  "msg": "未找到工作流作业节点",
  "data": null
}

字段说明

字段	类型	说明
`code`	string	错误代码。
`msg`	string	可读错误信息。
`data`	null	错误响应中为 `null`。

最后更新于 2026 年 9 月 28 日