重跑工作流实例录
更新时间：2025-08-07
接口描述
重新调度已经执行完成的工作流实例，支持全部任务重新调度，或者从上次失败的任务开始调度
权限说明
重跑工作流WORKFLOW的特定工作流实例，需要用户具有以下任一权限
- 运行工作流的权限: 运行
EXECUTE - 编辑工作流的权限: 编辑
MODIFY - 管理工作流的权限：管理
MANAGE
注意事项
- 工作流实例或者工作空间不存在，则重跑运行工作流实例失败
- 用户没有权限则重跑工作流实例失败
- 当重跑策略
strategy选择全流程重跑FROM_FIRST时，只有状态为运行失败FAILURE，成功SUCCESS、暂停PAUSE以及终止STOP的工作流实例可以重跑。 - 当重跑策略
strategy选择从失败的任务开始重跑FROM_FAILURE时，只有只有状态为运行失败FAILURE的工作流实例可以重跑
请求结构
Plain Text
1POST /v2/workspaces/{workspaceId}/job/run/{jobInstanceId}?rerun&&stragegy=FROM_FIRST HTTP/1.1
2Host: databuilder.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域
请求参数
Path参数
| 参数名 | 类型 | 是否必填 | 参数位置 | 说明 |
|---|---|---|---|---|
| workspaceId | String | 是 | Path参数 | 工作空间ID，不允许为空或者只包含空白字符 |
| jobInstanceId | String | 是 | Path参数 | 工作流实例ID，不允许为空或者只包含空白字符 |
| resume | String | 是 | Query参数 | 无需参数值，仅提供参数名即可 |
| strategy | String | 是 | Query参数 | 重跑策略：FROM_FAILURE： 从失败的任务开始重跑(包括失败的任务)FROM_FIRST： 全流程重跑 |
响应头域
除公共头域外，无其它特殊头域
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 请求ID |
| code | String | 响应码 |
| message | String | 响应码对应的响应描述信息 |
| result | String | 请求结果描述文本 |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| AccessDenied | 无操作权限 | 403 | 暂无操作权限 |
| NotExists | 工作流实例不存在 | 404 | 工作流实例不存在 |
| IllegalArgument | 参数错误 | 400 | 用户提供了非法的请求参数，或者工作流实例当前状态不允许停止 |
请求示例
Plain Text
1POST https://databuilder.bd.baidubce.com/v2/workspaces/workspace_9862_0763f283d58a/job/run/ins_8de75d63f92d3e53?rerun&&stragegy=START_FAILURE_TASK_PROCESS
2
3X-Region: bd
4X-Via: api-gateway
5Authorization: xxxxxx
6Host: host
7X-Bce-Request-Id: 75f4d4ad-d478-4494-95cd-74449a33365a
8Accept: */*
9Accept-Encoding: gzip, deflate, br
10Connection: keep-alive响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json
3Transfer-Encoding: chunked
4Date: Mon, 28 Jul 2025 05:36:55 GMT
5Keep-Alive: timeout=180
6Connection: keep-alive
7{
8 "requestId": "595a94a9-b004-49a2-8619-d3c69a979586",
9 "code": "success",
10 "message": "",
11 "result": "重跑运行记录运行记录[xxxxxx]成功。"
12}