创建、调度与结果恢复

先保存可查询的任务,再启动和读取终态。一个HTTP成功不能代替后续状态检查。

创建与重放

request_id位于请求体,作用域为工作区。相同标识且基础模型、归一后的训练/验证集、recipe及计算实例摘要匹配时返回原任务;改变这些输入可409冲突。保持原始recipe和标识,不能承诺任意JSON语义重排都视为同一摘要。

launch不进入创建摘要。launch=true在保存后另调用启动,启动失败时任务可能已经持久化,甚至已进入failed。恢复时保留request_id及原训练参数,先以launch=false重放创建取得既有job_id,再GET核对;不要保持launch=true反复触发调度,也不要换标识制造重复任务。

启动与工作流关联

启动先读取并补齐训练输入,再用条件写入claim标识;认领时可写running和started_at,这些值不证明Worker已经接收任务。随后准备、绑定并唤醒工作流,mowl_task_id/case_id才替换为真实关联。

已有真实绑定时返回或推进现有任务,不另建训练;遇到并发claim可返回当前记录。claim值带launching:前缀,只是内部占位,不能当工作流task/case调用。准备、绑定或唤醒失败会尝试写失败状态,响应错误后仍须回读任务。

创建者actor用于Catalog trace读取;运行WorkItem按正式延续身份恢复并校验任务工作区。工作区create权限、原任务身份和实际数据访问不能互相替代。

终态和取消

训练WorkItem需完成并返回非空适配器URI,启用存储时还校验URI前缀,然后保存succeeded。日志/指标持久化可独立失败,不能把成功训练状态写成诊断完整保存或模型发布成功。

取消针对非终态任务。有真实工作流绑定时先请求取消工作流,再保存cancelled;只有claim占位时不把占位值传入工作流取消。重复取消已终态任务409,不承诺无限幂等成功。实际训练按检查点处理取消,不能承诺请求返回时所有子进程已停止。

后台训练返回成功前会再次检查已取消状态;取消/完成竞态及多事务失败仍需实际环境复测。失败任务没有这些接口重试、删除、列举或发布入口,不能因为内部模型字段存在就补造端点。

错误与结果

HTTP/字符串code

选定合同

400 / ErrParamInvalid

必填字段、训练集划分、JSON或训练目标不合法。

400 / ErrWorkspaceRequired

工作区头与路径不匹配等输入错误。

401 / ErrUnauthenticated

handler要求的用户身份缺失;身份中间件拒绝另按正式认证合同。

403 / ErrPermissionDenied

业务授权拒绝。

404 / ErrNotFound

当前作用域下任务不可读取。

409 / ErrConflict

request_id输入冲突、任务不可启动或已不可取消。

500 / ErrServer

其他依赖或执行准备错误;任务可能已保存或发生部分调度。

错误说明和状态必须结合读取结果判断;没有为这些接口自动套上通用503错误表。完整运行错误、部署错误与认证包还需真实环境核对。

最后更新于