获取评测集导入任务列表 - ListOpsDatasetItemsImportTasks
功能介绍
该接口用于分页查询指定评测集下所有异步导入任务的执行状态、实时进度及详细统计信息,支持通过任务ID进行精确过滤。
适用场景:
URI
GET /v1/ops/datasets/{dataset_id}/items/import/tasks
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
dataset_id |
是 |
String |
参数解释: 评测集的ID。 约束限制: 由英文、数字、“-”、“_”组成,长度为1到64个字符。 取值范围: 1-64位字符。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
task_id |
否 |
String |
参数解释: 导入任务的唯一标识符(ID)。通过此参数可以筛选出特定导入任务产生的评测集记录。 约束限制: 长度为0到100个字符。 取值范围: 0到100字符。 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
参数解释: 消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。 约束限制: 不涉及 取值范围: 不涉及 默认取值: application/json |
|
Authorization |
是 |
String |
参数解释: 签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
X-Sdk-Date |
是 |
String |
参数解释: 请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
import_tasks |
Array of OpsImportTaskOutput objects |
参数解释: 包含多个导入任务详细执行状态的集合。 取值范围: 符合 OpsImportTaskOutput 结构的对象数组。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
task_id |
String |
参数解释: 导入任务的唯一标识符。 约束限制: 固定长度 36 字符的 UUID格式。 取值范围: 符合通用唯一识别码(UUID)标准的字符串。 默认取值: 不涉及。 |
|
status |
String |
参数解释: 导入任务的当前运行状态。 约束限制: 字符串格式。 取值范围: 默认取值: PENDING。 |
|
progress |
String |
参数解释: 任务执行的百分比进度。 约束限制: 带百分号的字符串格式。 取值范围: 0/ %到 100%。 默认取值: 0%。 |
|
success_count |
String |
参数解释: 导入成功的条目数量。 约束限制: 数字字符串。 取值范围: 大于等于 0 的整数字符串。 默认取值: "0"。 |
|
total_count |
String |
参数解释: 本次导入任务涉及的总数据条目数量。 约束限制: 数字字符串。 取值范围: 大于等于 0 的整数字符串。 默认取值: "0"。 |
|
error_detail |
String |
参数解释: 当任务状态为 FAILED 时,记录的详细错误信息或异常堆栈。 约束限制: 最大长度10000字符。 取值范围: 任意描述性字符串。 默认取值: 空字符串。 |
|
created_at |
String |
参数解释: 导入任务的发起时间。 约束限制: 符合 ISO 8601 标准的时间戳。 取值范围: UTC时间格式字符串。 默认取值: 不涉及。 |
请求示例
查询指定评测集下所有异步导入任务
GET https://*.com/agentarts/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" : "1",
"error_detail" : "error",
"created_at" : "2024-01-15T10:30:00Z"
} ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
返回查询指定评测集下所有异步导入任务 |
错误码
请参见错误码。