批量重试工作流作业

重试一个调度作业下的指定执行，或该调度作业下的全部失败执行。接口成功仅表示已接受批量重试请求。

POST https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps/{workflow_id}/executions/batch-retry

调用前准备

先查看工作流作业列表，确定工作流、源调度作业和需要重试的范围。准备具有目标工作区访问权限的个人访问令牌和目标工作区 ID。

请求体

将 $AI_STUDIO_API_KEY、$WORKSPACE_ID、$WORKFLOW_ID 和 $SOURCE_DISPATCH_JOB_ID 替换为实际值。execution_ids 与 all_failed: true 必须二选一。

curl -X POST "https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps/$WORKFLOW_ID/executions/batch-retry" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "source_dispatch_job_id": "'"$SOURCE_DISPATCH_JOB_ID"'",
    "all_failed": true,
    "request_id": "retry-20260828-001"
  }'

curl -X POST "https://api.moi.matrixorigin.cn/v5/workflow/v2/workflow-apps/$WORKFLOW_ID/executions/batch-retry" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "source_dispatch_job_id": "'"$SOURCE_DISPATCH_JOB_ID"'",
    "execution_ids": ["exec-001", "exec-002"],
    "request_id": "retry-20260828-002"
  }'

参数

类型

是否必填

说明

workflow_id

string

是

工作流 ID，位于请求路径中。

source_dispatch_job_id

string

是

源调度作业 ID。

execution_ids

array of string

条件必填

要重试的执行 ID；使用此字段时不要传 all_failed: true。

all_failed

boolean

条件必填

填 true 时重试源调度作业下的全部失败执行。

request_id

string

是

本次批量请求的唯一标识。

成功响应

成功时返回 200，并返回本次批量重试的受理信息。replayed 为 true 表示服务识别为同一 request_id 的重复提交。

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "source_dispatch_job_id": "dispatch-source-001",
    "dispatch_job_id": "dispatch-retry-001",
    "status": "waiting",
    "accepted_count": 1,
    "replayed": false
  }
}

字段

类型

说明

code

string

成功时为 OK。

msg

string

成功时为 OK。

data

object

本次批量重试的受理信息。

source_dispatch_job_id

string

源调度作业 ID。

dispatch_job_id

string

本次批量重试创建或复用的调度作业 ID。

status

string

批量重试请求当前状态。

accepted_count

integer

本次接受重试的执行数。

replayed

boolean

是否为同一 request_id 的重复请求。

错误响应

{
  "code": "ErrParamInvalid",
  "msg": "请求参数无效",
  "data": null
}

字段

类型

说明

code

string

错误代码。

msg

string

可读错误信息。

data

null

错误响应中为 null。

后续操作

使用响应中的调度作业 ID 查看工作流作业列表，确认重试执行的状态。

最后更新于