更新时间:2024-11-19 GMT+08:00
分享

查询测试任务列表

功能介绍

查询测试任务列表

URI

POST /GT3KServer/v4/{project_id}/versions/{version_id}/tasks/batch-query

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目id,对应"需求管理 CodeArts Req"项目唯一标识,测试计划管理页面地址栏url https://{host}/cloudtestportal/project/{project_id}/testplan中project_id变量的值

约束限制:

不涉及

取值范围:

项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字

默认取值:

不涉及

version_id

String

版本URI

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

uris

Array of strings

测试任务URI集合

keyword

String

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

tags

Array of strings

标签集合

own

Boolean

是否是我的

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

表4 响应Body参数

参数

参数类型

描述

total

Integer

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

value

TaskListVo object

实际的数据类型:单个对象,集合 或 NULL

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

branch_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_uuid

String

项目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 NameAndValueAndCodeVo 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 NameAndValueAndCodeVo

参数

参数类型

描述

name

String

名称

value

Integer

code

String

编码

状态码: 400

表10 响应Body参数

参数

参数类型

描述

code

String

业务失败的错误码

reason

String

业务失败的提示内容

状态码: 401

表11 响应Body参数

参数

参数类型

描述

code

String

业务失败的错误码

reason

String

业务失败的提示内容

状态码: 404

表12 响应Body参数

参数

参数类型

描述

code

String

业务失败的错误码

reason

String

业务失败的提示内容

状态码: 500

表13 响应Body参数

参数

参数类型

描述

code

String

业务失败的错误码

reason

String

业务失败的提示内容

请求示例

响应示例

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档