Skip to main content

暂停计划任务

千问办公企业旗舰版开发者文档:暂停计划任务。

认证方式见APP开发者文档 → 认证接入。
  • 模块:计划任务
  • 接口:POST/api/openapi/app/v1/scheduler/tasks/{task_id}/pause
  • operationId:pause-single-scheduled-task

接口说明

暂停后停止后续触发,不取消已经领取并开始交接的Session,也不取消正在运行的Agent。成功响应没有JSON正文。 接口只消费可信入口的当前用户;需启用Session计划组件且依赖就绪。支持单次与周期计划。

请求头

参数/字段位置类型必填说明
Content-TypeheaderstringJSON body时application/json

请求参数

参数/字段位置类型必填说明
task_idpathstring (uuid)是所属用户的非零任务UUID

成功响应

HTTP 204

无响应体。

拒绝与排查

HTTP错误语义
401缺少或无效的可信IAM用户入口身份;不能通过切换身份参数重试
404任务不存在或非当前用户;除执行流水外,软删除任务也不可读取
422无效任务ID、分页、请求体、触发规则或目标参数
503Session计划组件未启用或所需服务不可用
当前恢复已消费单次任务的拒绝是400 OPERATION_NOT_ALLOWED;不要把它当作任务成功恢复。错误体沿用Session现有运行时中间件,不套用管理后台错误码或生成器默认problem+json字段。保存trace_id排查,移除用户凭据。