
# 查询测试任务列表 - ListTasks
#### 功能介绍
此接口用于查询测试任务列表，同页面 测试 -\> 测试执行 -\> 右侧上方筛选分支，下方展示测试套列表
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /GT3KServer/v4/{project_id}/versions/{version_id}/tasks/batch-query
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **约束限制**: 字符串类型，长度32位字符 **取值范围**: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 **默认取值**: 不涉及                                           |
| version_id | 是    | String | **参数解释** 版本URI **约束限制** 不涉及 **取值范围** 11-34位字符 **默认取值** 不涉及 **获取方法**： 从GET /v4/projects/{project_id}/iterator-infos的返回字段获取 从GET /v1/{project_id}/branches 的返回字段获取 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 必传。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 |
   
表3请求Body参数 
| 参数                            | 是否必选 | 参数类型              | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| uris                          | 否    | Array of strings  | **参数解释** 测试任务URI集合 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| keyword                       | 否    | String            | **参数解释** 关键字查询 **约束限制** 不涉及 **取值范围** 任务名或编号 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| tags                          | 否    | Array of strings  | **参数解释** 标签集合 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| own                           | 否    | Boolean           | **参数解释** 是否是我的 **约束限制** 不涉及 **取值范围** true:是 false:否 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 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           | **参数解释** 当前页数 **约束限制** 不涉及 **取值范围** ≥1的整数 **默认取值** 1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| page_size                     | 否    | Integer           | **参数解释** 每页条数 **约束限制** 不涉及 **取值范围** ≥1的整数 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 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 | **参数解释** 请求返回的数据 **取值范围** 不涉及                           |
| reason    | String                                               | **参数解释** 业务失败的提示内容 **取值范围** 不涉及                         |
| page_size | Integer                                              | **参数解释** 分页大小 **取值范围** 大于0                              |
| page_no   | Integer                                              | **参数解释** 页码 **取值范围** 大于0                                |
| has_more  | Boolean                                              | **参数解释** 是否有更多 **取值范围** 不涉及                             |
   
 表5TaskListVo 
| 参数            | 参数类型                                                   | 描述                                                                                                                   |
|:---|:---|:---|
| tasks         | Array of [TaskVo] objects | **参数解释** 测试任务集合 **取值范围** 不涉及  |
| running_count | Integer                                                | **参数解释** 正在执行任务数 **取值范围** 不涉及 |
   
 表6TaskVo 
| 参数                             | 参数类型                                                                                 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| 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 **取值范围**: - -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                                                                               | **参数解释** 最近执行时间 **取值范围** 格式为yyyy-MM-dd HH:mm:ss                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| execute_latest_time_timestamp  | Long                                                                                 | **参数解释** 最近执行时间时间戳 **取值范围** 单位（毫秒）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| execute_duration               | String                                                                               | **参数解释** 执行时长 **取值范围** 单位（毫秒）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| execute_times                  | Integer                                                                              | **参数解释** 执行次数 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| project_uuid                   | String                                                                               | **参数解释** 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围** 固定长度为32位字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 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)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   
 表7CaseOperationVo 
| 参数                   | 参数类型                                                                       | 描述                                                                                                                    |
|:---|:---|:---|
| test_cases_info      | Array of [TaskAssignCaseVo] objects | **参数解释** 用例关联信息 **取值范围** 不涉及   |
| set_up_cases_info    | Array of [TaskAssignCaseVo] objects | **参数解释** 前置用例关联信息 **取值范围** 不涉及 |
| tear_down_cases_info | Array of [TaskAssignCaseVo] objects | **参数解释** 后置用例关联信息 **取值范围** 不涉及 |
   
 表8TaskAssignCaseVo 
| 参数               | 参数类型                                                   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| sort             | Integer                                                | **参数解释** 排序顺序 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| case_uri         | String                                                 | **参数解释** 用例uri **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| is_available     | Integer                                                | **参数解释** 是否可用 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| test_case_name   | String                                                 | **参数解释** 用例名称 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| test_case_number | String                                                 | **参数解释** 用例编号 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| svn_script_path  | String                                                 | **参数解释** 脚本路径 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| case_type        | Integer                                                | **参数解释**: 用例类型 **取值范围**: - 0，手工测试。   - 1，接口自动化。   - 2，性能用例。                                                                                                                                                                                                                                                                         |
| status           | [NameAndIdVo] object | **参数解释** 状态 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| result           | [NameAndIdVo] object | **参数解释** 结果 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| owner            | [NameAndIdVo] object | **参数解释** 责任人 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| rank             | Integer                                                | **参数解释** 用例等级 **取值范围** - 0，Priority 0。   - 1，Priority 1。   - 2，Priority 2。   - 3，Priority 3。   - 4，Priority 4。    |
| creation_date    | String                                                 | **参数解释** 创建时间 **取值范围** 字符串类型，时间格式为"yyyy-MM-dd HH:mm:ss"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| service_type     | Integer                                                | **参数解释** 执行方式 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
   
 表9NameAndIdVo 
| 参数   | 参数类型   | 描述                                                                                                              |
|:---|:---|:---|
| id   | String | **参数解释** ID **取值范围** 不涉及 |
| name | String | **参数解释** 名称 **取值范围** 不涉及 |
   
 表10NameAndValueAndCodeVo 
| 参数    | 参数类型    | 描述                                                                                                              |
|:---|:---|:---|
| name  | String  | **参数解释** 名称 **取值范围** 不涉及 |
| value | Integer | **参数解释** 值 **取值范围** 不涉及  |
| code  | String  | **参数解释** 编码 **取值范围** 不涉及 |
   
**状态码：400**
表11响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                       |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：401**
表12响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                       |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：404**
表13响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                       |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：500**
表14响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                       |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
#### 请求示例
```
post https://{endpoint}/GT3KServer/v4/dc3f9aa646ad4707831080d3fcce474d/versions/v92s00010db209le/tasks/batch-query
{
  "page_no" : 1,
  "page_size" : 15,
  "service_type" : 0
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "total" : 1,
  "value" : {
    "tasks" : [ {
      "uri" : "v92s00010db20ank",
      "name" : "第一批次执行",
      "number" : "108",
      "region" : "cn-north-7",
      "author_id" : "f3b807a0d249424fa36a0d804110c4ed",
      "author_name" : "这是高总的昵称",
      "owner_id" : "f3b807a0d249424fa36a0d804110c4ed",
      "owner_name" : "这是高总的昵称",
      "parent_path" : "/dc3f9aa646ad4707831080d3fcce474d/v92s00010db208e5/",
      "version_uri" : "v92s00010db208e5",
      "creation_date" : "2025-04-17 16:24:38",
      "create_date_timestamp" : 1744878278000,
      "update_time" : "2025-04-17 16:24:38",
      "update_time_timestamp" : 1744878278000,
      "relation_change_time" : "2025-04-17 16:24:38",
      "relation_change_time_timestamp" : 1744878278000,
      "updator_id" : "f3b807a0d249424fa36a0d804110c4ed",
      "updator_name" : "这是高总的昵称",
      "relation_changer_id" : "f3b807a0d249424fa36a0d804110c4ed",
      "service_type" : 0,
      "service_type_name" : "手工测试",
      "tag_list" : [ ],
      "execute_way" : 1,
      "execute_type" : 0,
      "status_code" : 0,
      "status_name" : "新建",
      "result_code" : 0,
      "result_name" : "成功",
      "execute_status_code" : 0,
      "execute_status_name" : "未执行",
      "executor_id" : "f3b807a0d249424fa36a0d804110c4ed",
      "executor_name" : "这是高总的昵称",
      "execute_latest_time" : "2025-04-17 16:24:38",
      "execute_latest_time_timestamp" : 1744878278000,
      "project_uuid" : "dc3f9aa646ad4707831080d3fcce474d",
      "assign_case_num" : 6,
      "finish_case_num" : 0,
      "assign_defect_num" : 0,
      "result_number_list" : [ {
        "name" : "未执行",
        "value" : 5,
        "code" : ""
      }, {
        "name" : "成功",
        "value" : 1,
        "code" : "0"
      } ]
    } ],
    "running_count" : 0
  },
  "page_size" : 15,
  "page_no" : 1
}
```
#### SDK代码示例
SDK代码示例如下。
#### Java
```
package com.huaweicloud.sdk.test;
import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.cloudtest.v1.region.CloudtestRegion;
import com.huaweicloud.sdk.cloudtest.v1.*;
import com.huaweicloud.sdk.cloudtest.v1.model.*;
public class ListTasksSolution {
    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        ICredential auth = new BasicCredentials()
                .withAk(ak)
                .withSk(sk);
        CloudtestClient client = CloudtestClient.newBuilder()
                .withCredential(auth)
                .withRegion(CloudtestRegion.valueOf("<YOUR REGION>"))
                .build();
        ListTasksRequest request = new ListTasksRequest();
        request.withVersionId("{version_id}");
        request.withProjectId("{project_id}");
        TasksQueryInfo body = new TasksQueryInfo();
        body.withPageSize(15);
        body.withPageNo(1);
        body.withServiceType(0);
        request.withBody(body);
        try {
            ListTasksResponse response = client.listTasks(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}
```
#### Python
```
# coding: utf-8
import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkcloudtest.v1.region.cloudtest_region import CloudtestRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcloudtest.v1 import *
if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    credentials = BasicCredentials(ak, sk)
    client = CloudtestClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(CloudtestRegion.value_of("<YOUR REGION>")) \
        .build()
    try:
        request = ListTasksRequest()
        request.version_id = "{version_id}"
        request.project_id = "{project_id}"
        request.body = TasksQueryInfo(
            page_size=15,
            page_no=1,
            service_type=0
        )
        response = client.list_tasks(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)
```
#### Go
```
package main
import (
"fmt"
"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    cloudtest "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cloudtest/v1"
"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cloudtest/v1/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cloudtest/v1/region"
)
func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    auth, err := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        SafeBuild()
    if err != nil {
        fmt.Println(err)
        return
    }
    hcClient, err := cloudtest.CloudtestClientBuilder().
         WithRegion(region.ValueOf("<YOUR REGION>")).
         WithCredential(auth).
         SafeBuild()
    if err != nil {
        fmt.Println(err)
        return
    }
    client := cloudtest.NewCloudtestClient(hcClient)
    request := &model.ListTasksRequest{}
request.VersionId = "{version_id}"
request.ProjectId = "{project_id}"
pageSizeTasksQueryInfo:= int32(15)
pageNoTasksQueryInfo:= int32(1)
serviceTypeTasksQueryInfo:= int32(0)
request.Body = &model.TasksQueryInfo{
PageSize: &pageSizeTasksQueryInfo,
PageNo: &pageNoTasksQueryInfo,
ServiceType: &serviceTypeTasksQueryInfo,
}
response, err := client.ListTasks(request)
if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}
```
#### 更多
更多编程语言的SDK代码示例，请参见[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CloudTest/sdk?api=ListTasks)的代码示例页签，可生成自动对应的SDK代码示例。
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。
