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

查询测试任务列表 - ShowTasks

功能介绍

此接口用于查询测试套列表,对应页面 测试 -> 测试执行 -> 测试套列表页

调用方法

请参见如何调用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

参数解释:

服务类型

约束限制:

不涉及

取值范围:

  • -1，全量用例。

  • 0，手工测试。

  • 1，接口自动化。

  • 7，功能自动化。

  • 8，WebUI自动化。

  • 100，自定义自动化(工厂)。

  • 11，性能自动化。

默认取值:

不涉及

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

参数解释:

排序方式

约束限制:

不涉及

取值范围:

  • ASC，升序。

  • DESC，降序。

默认取值:

不涉及

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参数

参数

参数类型

描述

value

TaskListVo object

查询测试任务列表结果
表4 TaskListVo

参数

参数类型

描述

tasks

Array of TaskVo objects

测试任务集合

running_count

Integer

正在执行任务数
表5 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

取值范围:

  • -1，全量用例。

  • 0，手工测试。

  • 1，接口自动化。

  • 7，功能自动化。

  • 8，WebUI自动化。

  • 100，自定义自动化(工厂)。

  • 11，性能自动化。

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)
表6 CaseOperationVo

参数

参数类型

描述

test_cases_info

Array of TaskAssignCaseVo objects

用例关联信息

set_up_cases_info

Array of TaskAssignCaseVo objects

前置用例关联信息

tear_down_cases_info

Array of TaskAssignCaseVo objects

后置用例关联信息
表7 TaskAssignCaseVo

参数

参数类型

描述

sort

Integer

排序顺序

case_uri

String

用例uri

is_available

Integer

是否可用

test_case_name

String

用例名称

test_case_number

String

用例编号
表8 NameAndValueVo

参数

参数类型

描述

name

String

参数解释:

名称

取值范围:

不涉及

value

Integer

参数解释:

值

取值范围:

不涉及

状态码：400

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码：401

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码：404

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码：500

表12 响应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

OK

{
  "value" : {
    "tasks" : [ ],
    "running_count" : 0
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题： 测试套管理

相关文档