查看文件执行记录¶

根据文件 ID 查看由该文件触发的工作流作业记录。未提供文件 ID 时返回空列表。

GET https://moi.matrixorigin.cn/newmoi/workflow/v2/workflow-apps/file-executions

调用前准备¶

准备具有目标工作区访问权限的个人访问令牌、目标工作区 ID和要查询的文件 ID。

查询参数¶

将 $AI_STUDIO_API_KEY、$WORKSPACE_ID 和 $FILE_ID 替换为实际值。

调用示例

curl "https://moi.matrixorigin.cn/newmoi/workflow/v2/workflow-apps/file-executions?file_id=$FILE_ID" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

参数说明

参数	类型	是否必填	说明
`file_id`	string	否	要查询的文件 ID；省略时返回空列表。

成功响应¶

成功时返回 200 和关联的作业记录。

响应示例

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "executions": [
      {
        "execution_id": "run-001",
        "workflow_id": "wf-001",
        "status": "completed"
      }
    ],
    "total": 1
  }
}

字段说明

通用字段

字段	类型	说明
`code`	string	成功时为 `OK`。
`msg`	string	成功时为 `OK`。
`data`	object	响应数据。
`executions`	array of object	文件关联的作业记录。
`total`	integer	匹配记录总数。

作业记录

下面表格展开响应示例中 executions 列表的一项；每一行是一个作业字段。

字段	类型	说明
`execution_id`	string	作业 ID。
`workflow_id`	string	工作流 ID；有值时返回。
`status`	string	当前或最终作业状态。
`execution_mode`	string	执行方式；有值时返回。
`started_at`	string	开始时间；有值时返回。
`ended_at`	string	结束时间；有值时返回。
`created_at`	string	创建时间；有值时返回。
`updated_at`	string	最后更新时间；有值时返回。
`case_id`	string	关联案例 ID；有值时返回。
`scheduler_visible`	boolean	是否对调度器可见。
`case_start_state`	string	案例启动状态；有值时返回。
`error`	string	执行错误；有值时返回。

错误响应¶

响应示例

{
  "code": "ErrWorkspaceIDMissing",
  "msg": "需要工作区 ID",
  "data": null
}

字段说明

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

最后更新于 2026 年 9 月 3 日