查询测试任务列表 - ShowTasks
功能介绍
此接口用于查询测试套列表,对应页面 测试 -> 测试执行 -> 测试套列表页
调用方法
请参见如何调用API。
URI
POST /v4/{project_id}/versions/{version_uri}/tasks/batch-query
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID。 |
version_uri | 是 | String | 版本URI |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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
参数 | 参数类型 | 描述 |
|---|---|---|
value | TaskListVo object | 查询测试任务列表结果 |
参数 | 参数类型 | 描述 |
|---|---|---|
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) |
参数 | 参数类型 | 描述 |
|---|---|---|
test_cases_info | Array of TaskAssignCaseVo objects | 用例关联信息 |
set_up_cases_info | Array of TaskAssignCaseVo objects | 前置用例关联信息 |
tear_down_cases_info | Array of TaskAssignCaseVo objects | 后置用例关联信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
sort | Integer | 排序顺序 |
case_uri | String | 用例uri |
is_available | Integer | 是否可用 |
test_case_name | String | 用例名称 |
test_case_number | String | 用例编号 |
状态码:400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg | String | 参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码:401
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg | String | 参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码:404
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释 接口调用失败错误码 取值范围 不涉及 |
error_msg | String | 参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码:500
参数 | 参数类型 | 描述 |
|---|---|---|
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 |
错误码
请参见错误码。

