查询测试任务列表 - 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 |
错误码
请参见错误码。