文档首页/ 智果（AgentArts）智能体平台/ API参考/ API/ 评估/ 评估任务管理/ 批量删除任务 - BatchDeleteOpsEvaluationTasks
更新时间：2026-09-24 GMT+08:00
查看PDF
分享

批量删除任务 - BatchDeleteOpsEvaluationTasks

功能介绍

该接口用于批量删除指定的评估任务，支持一次性删除多个任务，批量返回删除结果，适用于任务清理的场景。

适用场景：

  • 清理不再需要的历史评估任务。

  • 批量删除测试或错误创建的任务。

  • 管理项目中的任务列表以保持系统整洁。

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:evaluationTask:batchDeleteOpsEvaluationTasks

Write

evaluationTask *

g:ResourceTag/<tag-key>

-

-

URI

DELETE /v1/ops/evaluation-tasks

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

task_ids

是

Array of strings

参数解释：

需要批量删除的任务ID列表，数组内每个元素为String类型的任务ID。可通过查询评估任务列表接口获取。

约束限制：

数组长度为1到1000。

取值范围：

不涉及。

响应参数

状态码：204

表2 响应Body参数

参数

参数类型

描述

data

data object

参数解释：

批量删除结果对象。

取值范围：

不涉及。
表3 data

参数

参数类型

描述

success_ids

Array of strings

参数解释：

成功删除的任务ID列表。

取值范围：

不涉及。

failed_ids

Array of strings

参数解释：

删除失败的任务ID列表（通常因为ID不存在、状态已删除或权限不足）。

取值范围：

不涉及。

total_requested

Integer

参数解释：

请求删除的任务总数。

取值范围：

非负整数。

total_deleted

Integer

参数解释：

实际删除成功的任务数。

取值范围：

非负整数。

请求示例

批量删除指定的评估任务

DELETE https://api.example.com/v1/ops/evaluation-tasks

{
  "task_ids" : [ "1769435753746015000830", "1769436861475995400862" ]
}

响应示例

状态码：204

{
  "data" : {
    "success_ids" : [ "1769435753746015000830" ],
    "failed_ids" : [ ],
    "total_requested" : 2,
    "total_deleted" : 1
  }
}

状态码

状态码

描述

204

批量删除任务（返回 {data: {success_ids, failed_ids, total_requested, total_deleted}}）

错误码

请参见错误码。

父主题： 评估任务管理

相关文档