文档首页/ 代码检查 CodeArts Check/ API参考/ API/ 任务管理/ 删除任务 - DeleteTaskV3
更新时间：2025-12-09 GMT+08:00
在线调试
CLI示例
查看PDF
分享

删除任务 - DeleteTaskV3

功能介绍

删除任务。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

codeartscheck:task:delete

Write

task *

-

-

-

-

codeartscheck:ProjectId

URI

DELETE /v3/task/{task_id}

表1 路径参数

参数

是否必选

参数类型

描述

task_id

是

String

参数解释：

任务ID，即新建检查任务接口的返回值，每个CodeArtsCheck任务及其下的分支任务、通过API创建的增量任务都有唯一的任务ID。

约束限制：

不涉及。

取值范围：

字符串长度不少于1，不超过128。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

operator

否

String

参数解释：

操作者。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

httpStatus

String

参数解释：

HTTP响应状态。

取值范围：

  • OK，接口响应成功。

  • ACCEPTED，接口响应成功。

  • INTERNAL_SERVER_ERROR，接口内部异常。

  • BAD_REQUEST，参数校验异常。

result

String

参数解释：

删除成功时，result为"true"。

取值范围：

不涉及。

status

String

参数解释：

接口响应状态。

取值范围：

  • success，接口响应成功。

  • error，接口响应失败。

请求示例

删除任务ID为897acf5exxx48a5013cd的代码检查任务。

DELETE https://{endpoint}/v3/task/897acf5exxx48a5013cd

响应示例

状态码：200

删除任务成功

{
  "httpStatus" : "OK",
  "result" : true,
  "status" : "success"
}

状态码

状态码

描述

200

删除任务成功

错误码

请参见错误码。

父主题： 任务管理

相关文档