跳转到主要内容
POST /api/v1/forward/batches/{batch_id}/cancel 发起取消后,Forward 会清空队列、取消 pending 任务,并对 running task 调用 CancelSession。

请求头

路径参数

示例请求

示例响应

HTTP 200 OK
响应为发起取消时的状态快照:若仍有 running task,status 为中间态 cancelling;若无 running task 则直接返回 cancelled。已处终态的 Batch 幂等返回当前对象。

响应字段

取消流程

  1. 已处于终态的 Batch:幂等返回 200,不做任何操作。
  2. CAS 状态转换 validating|queued|processing → cancelling
  3. 清空 Redis 队列,批量标记 pending 任务为 cancelled
  4. 对每个 running task 调用 CancelSession
  5. 若无 running task,立即触发 finalize;否则等待最后一个 CompleteTask 驱动 finalize。

错误码

注意事项

  • 取消是异步操作,响应 cancelling 表示已发起取消,需轮询详情确认终态。
  • 终态 Batch 取消为幂等操作,返回 200

相关

查询 Batch 详情

获取输出文件