# 查询用户已授权项目下测试任务列表 - ShowAuthorizedTasks #### 功能介绍 此接口用于查询测试任务列表，同页面 测试 -\> 测试执行 -\> 右侧展示测试任务列表 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/{project_id}/authorized-tasks/batch-query 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | keyword | 否 | String | 关键字查询，任务名或编号 | | service_type | 否 | Integer | **参数解释**: 服务类型 **约束限制**: 不涉及 **取值范围**: - -1，全量用例。 - 0，手工测试。 - 1，接口自动化。 - 7，功能自动化。 - 8，WebUI自动化。 - 100，自定义自动化(工厂)。 - 11，性能自动化。 **默认取值**: 不涉及 | | page_no | 是 | Integer | 当前页数 | | page_size | 是 | Integer | 每页条数 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 | | value | Array of [TaskVo] objects | 实际的数据类型：单个对象，集合 或 NULL | | reason | String | 业务失败的提示内容 | | page_size | Integer | 分页大小 | | page_no | Integer | 分页编码 | | has_more | Boolean | 是否有更多 | 表4TaskVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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) | 表5CaseOperationVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | test_cases_info | Array of [TaskAssignCaseVo] objects | **参数解释** 用例关联信息 **取值范围** 不涉及 | | set_up_cases_info | Array of [TaskAssignCaseVo] objects | **参数解释** 前置用例关联信息 **取值范围** 不涉及 | | tear_down_cases_info | Array of [TaskAssignCaseVo] objects | **参数解释** 后置用例关联信息 **取值范围** 不涉及 | 表6TaskAssignCaseVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | **参数解释** 执行方式 **取值范围** 不涉及 | 表7NameAndIdVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释** ID **取值范围** 不涉及 | | name | String | **参数解释** 名称 **取值范围** 不涉及 | 表8NameAndValueAndCodeVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释** 名称 **取值范围** 不涉及 | | value | Integer | **参数解释** 值 **取值范围** 不涉及 | | code | String | **参数解释** 编码 **取值范围** 不涉及 | **状态码：400** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：401** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：404** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：500** 表12响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | #### 请求示例 ``` post https://{endpoint}/v4/2e8b14eb90d54b6c9bc4c0b5cde1f449/authorized-tasks/batch-query { "keyword" : "任务名", "service_type" : 0, "page_no" : 1, "page_size" : 10 } ``` #### 响应示例 **状态码：200** OK ``` { "total" : 1, "value" : [ { "uri" : "001s16gt6q5", "name" : "名称01", "stage" : "alpha", "number" : "编号01", "tags" : "e79798f0f4424f16b189558bad1206aa,6e3c9767092948f0bd15d4f1b479ee0c", "description" : "描述", "region" : "cn-north-7", "author_id" : "b088303066476b9eaefdb44aa23bca", "author_name" : "创建人名称", "owner_id" : "efdb403066474ab08836b9eaa23bca", "owner_name" : "责任人名称", "parent_uri" : "00rt40cvpkq", "parent_path" : "/d2017a1b4fbd4a8e995611c2d6e0c301/01hs9bgkr98/", "origin_uri" : "d1j2f30cvpkq", "version_uri" : "b9eaw1es2fdb12", "branch_uri" : "b9eaw1es2fdb12", "version_name" : "分支", "creation_date" : "2025-06-20T06:23:44.922Z", "create_date_timestamp" : 1660617231016, "update_time" : "2025-06-20T06:23:44.922Z", "update_time_timestamp" : 1660617231016, "relation_change_time" : "2025-06-20T06:23:44.922Z", "relation_change_time_timestamp" : 1660617231016, "test_case_condition" : "[{\"fieldName\":\"autoType\",\"fieldValue\":\"0\",\"operator\":\"=\"}]", "updator_id" : "b088303066476b9eaefdb44aa23bca", "updator_name" : "名称01", "relation_changer_id" : "b088303066476b9eaefdb44aa23bca", "service_type" : 0, "service_type_name" : "功能测试", "tag_list" : [ "标签1" ], "module_id" : "hyuiugifdso", "module_name" : "模块名称01", "module_path" : "id1/id2", "module_path_name" : "模块1/模块2", "release_dev" : "版本号01", "ext_param" : "扩展参数", "execute_way" : 1, "execute_type" : 1, "status_code" : 1, "status_name" : "1", "result_code" : 1, "result_name" : "1", "execute_status_code" : 1, "execute_status_name" : "运行中", "executor_id" : "11hj3qaw4jnkdsfts", "executor_name" : "执行人名称", "execute_latest_time" : "2025-06-20T06:23:44.922Z", "execute_latest_time_timestamp" : 1660617231016, "execute_duration" : "00:00:42", "execute_times" : 1, "project_uuid" : "klasier2dfj3qaw4jedfts", "case_operation_info" : { }, "assign_case_num" : 2, "finish_case_num" : 2, "assign_defect_num" : 2, "task_assign_msg" : "任务创建成功，%s条用例成功添加，%s条用例不存在无法添加。", "iterator_version_uri" : "001ta94t35a", "result_number_list" : [ { "name" : "新建", "value" : 22 } ], "finish_date" : "2025-06-20T06:23:44.923Z", "finish_date_timestamp" : 1660617231016, "plan_start_date" : "2025-06-20T06:23:44.923Z", "plan_start_timestamp" : 1660617231016, "plan_end_date" : "2025-06-20T06:23:44.923Z", "plan_end_timestamp" : 1660617261016, "expiration_status" : 0, "expiration_status_name" : "未超期" } ], "reason" : "string", "page_size" : 0, "page_no" : 0, "has_more" : true } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。