# 获取评测集导入任务列表 - ListOpsDatasetItemsImportTasks #### 功能介绍 该接口用于分页查询指定评测集下所有异步导入任务的执行状态、实时进度及详细统计信息，支持通过任务ID进行精确过滤。 适用场景： - 进度查看：在提交大规模数据导入请求后，实时跟踪任务的完成百分比与当前处理状态。 - 历史追溯：复盘评测集内容的来源、导入时间及各批次任务的执行结果。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | agentarts:dataset:listOpsDatasetItemsImportTasks | List | dataset \* | g:ResourceTag/\ | - | - | #### URI GET /v1/ops/datasets/{dataset_id}/items/import/tasks 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | dataset_id | 是 | String | **参数解释：** 评测集的唯一标识符（ID）。可通过调用创建评测集接口获取，或通过查询评测集列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 由英文、数字、连字符(-)、下划线(_)组成的1\~64个字符串。 **默认取值：** 无。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | task_id | 否 | String | **参数解释：** 导入任务的唯一标识符（ID）。通过此参数可以筛选出特定导入任务产生的评测集记录。可通过调用获取评测集导入任务列表接口获取。 **约束限制：** 不涉及。 **取值范围：** 符合UUID标准格式，长度为36个字符的字符串。 **默认取值：** 不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | import_tasks | Array of [OpsImportTaskOutput] objects | **参数解释：** 包含多个导入任务详细执行状态的集合，元素为OpsImportTaskOutput对象。 **取值范围：** 不涉及。 | 表4OpsImportTaskOutput | 参数 | 参数类型 | 描述 | |:---|:---|:---| | task_id | String | **参数解释：** 导入任务的唯一标识符。 **取值范围：** 符合通用唯一识别码(UUID)标准的字符串。 | | status | String | **参数解释：** 导入任务的当前运行状态。 **取值范围：** - PENDING：等待中，任务已创建但尚未开始执行 - RUNNING：运行中，任务正在执行 - SUCCESS：成功，任务执行完成且成功 - FAILED：失败，任务执行失败 | | progress | String | **参数解释：** 任务执行的百分比进度。 **取值范围：** 由数字和百分号(%)组成的字符串，0%到100%。 | | success_count | String | **参数解释：** 导入成功的条目数量。 **取值范围：** 大于等于0的整数字符串。 | | total_count | String | **参数解释：** 本次导入任务涉及的总数据条目数量。 **取值范围：** 0-100的整数字符串。 | | error_detail | String | **参数解释：** 当任务状态为 FAILED 时，记录的详细错误信息或异常堆栈。 **取值范围：** 不涉及。 | | created_at | String | **参数解释：** 导入任务的发起时间。使用UTC时间格式，格式为yyyy-MM-ddTHH:mm:ssZ，例如2024-01-01T00:00:00Z **取值范围：** 不涉及。 | #### 请求示例 查询指定评测集下所有异步导入任务 ``` GET https://api.example.com/v1/ops/datasets/52bf21f819-6f91-4568-9f2f-57ef956/items/import/tasks ``` #### 响应示例 **状态码：200** 返回查询指定评测集下所有异步导入任务 ``` { "import_tasks" : [ { "task_id" : "550e8400-e29b-41d4-a716-446655440001", "status" : "RUNNING", "progress" : "50%", "success_count" : "10", "total_count" : "20", "created_at" : "2024-01-15T10:30:00Z" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 返回查询指定评测集下所有异步导入任务 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。