# 查询测试任务列表 - ShowTasks #### 功能介绍 此接口用于查询测试套列表,对应页面 测试 -\> 测试执行 -\> 测试套列表页 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/{project_id}/versions/{version_uri}/tasks/batch-query 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html)。 | | 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 | 查询测试任务列表结果 | 表4TaskListVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | tasks | Array of [TaskVo] objects | 测试任务集合 | | running_count | Integer | 正在执行任务数 | 表5TaskVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html)。 | | 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) | 表6CaseOperationVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | test_cases_info | Array of [TaskAssignCaseVo] objects | 用例关联信息 | | set_up_cases_info | Array of [TaskAssignCaseVo] objects | 前置用例关联信息 | | tear_down_cases_info | Array of [TaskAssignCaseVo] objects | 后置用例关联信息 | 表7TaskAssignCaseVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | sort | Integer | 排序顺序 | | case_uri | String | 用例uri | | is_available | Integer | 是否可用 | | test_case_name | String | 用例名称 | | test_case_number | String | 用例编号 | 表8NameAndValueVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释**: 名称 **取值范围**: 不涉及 | | value | Integer | **参数解释**: 值 **取值范围**: 不涉及 | | children | [NameAndValueVo] object | 子节点 | | tag_value | Integer | 标记值，补充字段，区分与value | **状态码：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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。