文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试套管理/ 查询测试任务列表
更新时间：2025-07-24 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询测试任务列表

功能介绍

查询测试任务列表

调用方法

请参见如何调用API。

URI

POST /v4/{project_id}/versions/{version_uri}/tasks/batch-query

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID。

version_uri

是

String

版本URI

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

uris

否

Array of strings

测试任务URI集合

keyword

否

String

关键字查询，任务名或编号

tags

否

Array of strings

标签集合

service_type

否

Integer

服务类型

release_dev_list

否

Array of strings

发布版本号集合

result_codes

否

Array of strings

结果Code集合

status_codes

否

Array of strings

状态Code集合

owner_ids

否

Array of strings

责任人ID集合

executor_ids

否

Array of strings

执行者ID集合

creator_ids

否

Array of strings

创建者ID集合

sort_field

否

String

排序字段

sort_type

否

String

排序方式

page_no

否

Integer

当前页数

page_size

否

Integer

每页条数

is_polling_query

否

Boolean

是否轮询查询

is_query_associated_case_list

否

Boolean

是否获取关联用例列表

plan_start_start_timestamp

否

Long

计划开始时间过滤起始时间戳

plan_start_end_timestamp

否

Long

计划开始时间过滤结束时间戳

plan_end_start_timestamp

否

Long

计划结束时间过滤起始时间戳

plan_end_end_timestamp

否

Long

计划结束时间过滤结束时间戳

expiration_status_list

否

Array of integers

测试套超期状态过滤，超期状态值分别为：无状态(null)、未超期(0)、即将超期(1)、已超期(2)、延期完成(3)、按期完成(4)

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

status

String

success|error

result

ResultValueTaskListVo object

查询测试任务列表结果

error

ApiError object

错误信息

request_id

String

由接口调用方传入，建议使用UUID保证请求的唯一性。

server_address

String

本次请求的受理的服务地址
表4 ResultValueTaskListVo

参数

参数类型

描述

total

Integer

起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值

value

TaskListVo object

任务列表

reason

String

业务失败的提示内容

page_size

Integer

分页大小

page_no

Integer

分页编码

has_more

Boolean

是否有更多
表5 TaskListVo

参数

参数类型

描述

tasks

Array of TaskVo objects

测试任务集合

running_count

Integer

正在执行任务数
表6 TaskVo

参数

参数类型

描述

uri

String

测试任务URI

name

String

测试任务名称

stage

String

测试阶段

number

String

编号

tags

String

标签

description

String

描述

region

String

区域

author_id

String

创建人ID

author_name

String

创建人名称

owner_id

String

责任人ID

owner_name

String

责任人名称

parent_uri

String

父任务URI

parent_path

String

父任务路径

origin_uri

String

源任务URI

version_uri

String

版本URI

version_name

String

版本名称

creation_date

String

创建时间

create_date_timestamp

Long

创建时间时间戳

update_time

String

更新时间

update_time_timestamp

Long

更新时间时间戳

relation_change_time

String

关联关系修改时时间

relation_change_time_timestamp

Long

关联关系修改时间时间戳

test_case_condition

String

动态任务用例过滤条件

updator_id

String

修改人Id

updator_name

String

修改人名称

relation_changer_id

String

关联关系修改人Id

service_type

Integer

服务类型ID

service_type_name

String

服务类型名称

tag_list

Array of strings

标签名称集合

module_id

String

模块ID

module_name

String

模块名称

module_path

String

模块path

module_path_name

String

模块路径名称

release_dev

String

发布版本号

ext_param

String

扩展参数

execute_way

Integer

执行方式（1：串行，2：并行）

execute_type

Integer

执行类型（0：冒烟，1：定时）

status_code

Integer

生命周期状态Code

status_name

String

生命周期状态名称

result_code

Integer

执行结果Code

result_name

String

执行状态名称

execute_status_code

Integer

Echo执行状态Code

execute_status_name

String

Echo执行状态名称

executor_id

String

执行人ID

executor_name

String

执行人名称

execute_latest_time

String

最近执行时间

execute_latest_time_timestamp

Long

最近执行时间时间戳

execute_duration

String

执行时长

execute_times

Integer

执行次数

project_id

String

项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID。

case_operation_info

CaseOperationVo object

任务关联用例信息

assign_case_num

Integer

关联用例数

finish_case_num

Integer

已完成用例数量

assign_defect_num

Integer

关联缺陷数量

task_assign_msg

String

任务关联用例变更提示信息

iterator_version_uri

String

测试套所属迭代uri，非迭代下创建的测试套返回null

result_number_list

Array of NameAndValueVo objects

用户自定义结果对应的用例数目

finish_date

String

测试套完成时间

finish_date_timestamp

Long

测试套完成时间戳

plan_start_date

String

计划开始时间

plan_start_timestamp

Long

计划开始时间戳

plan_end_date

String

计划结束时间

plan_end_timestamp

Long

计划结束时间戳

expiration_status

Integer

测试套超期状态值，分别为：无状态(null)、未超期(0)、即将超期(1)、已超期(2)、延期完成(3)、按期完成(4)

expiration_status_name

String

测试套超期状态名称，分别为：无状态(不显示状态)、未超期(Unexpired)、即将超期(About to expire)、已超期(Expired)、延期完成(Delayed completion)、按期完成(On schedule completion)
表7 CaseOperationVo

参数

参数类型

描述

test_cases_info

Array of TaskAssignCaseVo objects

用例关联信息

set_up_cases_info

Array of TaskAssignCaseVo objects

前置用例关联信息

tear_down_cases_info

Array of TaskAssignCaseVo objects

后置用例关联信息
表8 TaskAssignCaseVo

参数

参数类型

描述

sort

Integer

排序顺序

case_uri

String

用例uri

is_available

Integer

是否可用

test_case_name

String

用例名称

test_case_number

String

用例编号
表9 NameAndValueVo

参数

参数类型

描述

name

String

参数解释:

名称

取值范围:

不涉及

value

Integer

参数解释:

值

取值范围:

不涉及
表10 ApiError

参数

参数类型

描述

code

String

参数解释

错误编码

取值范围

不涉及

reason

String

参数解释

业务失败的提示内容

取值范围

不涉及

状态码：400

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码：401

表12 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码：404

表13 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码：500

表14 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

请求示例

post https://{endpoint}/v4/9a5b66157ff44f6f80ce5f0fd1709f21/versions/v92s00010cmov0d6/tasks/batch-query

{
  "page_no" : 1,
  "page_size" : 15,
  "service_type" : -1
}

响应示例

状态码：200

查询测试任务列表返回体

{
  "status" : "success",
  "result" : {
    "total" : 0,
    "value" : {
      "tasks" : [ ],
      "running_count" : 0
    },
    "page_size" : 15,
    "page_no" : 1
  }
}

状态码

状态码

描述

200

查询测试任务列表返回体

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题： 测试套管理

相关文档