POST /api/v1/forward/batches/{batch_id}/cancel
发起取消后,Forward 会清空队列、取消 pending 任务,并对 running task 调用 CancelSession。
请求头
路径参数
示例请求
示例响应
HTTP 200 OKstatus 为中间态 cancelling;若无 running task 则直接返回 cancelled。已处终态的 Batch 幂等返回当前对象。
响应字段
取消流程
- 已处于终态的 Batch:幂等返回
200,不做任何操作。 - CAS 状态转换
validating|queued|processing → cancelling。 - 清空 Redis 队列,批量标记 pending 任务为
cancelled。 - 对每个 running task 调用
CancelSession。 - 若无 running task,立即触发 finalize;否则等待最后一个
CompleteTask驱动 finalize。
错误码
注意事项
- 取消是异步操作,响应
cancelling表示已发起取消,需轮询详情确认终态。 - 终态 Batch 取消为幂等操作,返回
200。