文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试套管理/ 查询用户已授权项目下测试任务列表

更新时间：2025-07-24 GMT+08:00

在线调试

CLI示例

查看PDF

查询用户已授权项目下测试任务列表

功能介绍

查询用户已授权项目下测试任务列表

调用方法

请参见如何调用API。

URI

POST /v4/{project_id}/authorized-tasks/batch-query

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
keyword	否	String	关键字查询，任务名或编号
service_type	否	Integer	服务类型
page_no	否	Integer	当前页数
page_size	否	Integer	每页条数

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
status	String	success\|error
result	ResultValueListTaskVo object	请求返回的数据
error	ApiError object	错误信息
request_id	String	由接口调用方传入，建议使用UUID保证请求的唯一性。
server_address	String	本次请求的受理的服务地址

表4 ResultValueListTaskVo
参数	参数类型	描述
total	Integer	起始记录数大于实际总条数时，值为0，分页请求才有此值
value	Array of TaskVo objects	实际的数据类型：单个对象，集合或 NULL
reason	String	业务失败的提示内容
page_size	Integer	分页大小
page_no	Integer	分页编码
has_more	Boolean	是否有更多

表5 TaskVo
参数	参数类型	描述
uri	String	参数解释测试任务URI 取值范围不涉及
name	String	参数解释测试任务名称取值范围不涉及
stage	String	参数解释测试阶段取值范围不涉及
number	String	参数解释编号取值范围不涉及
tags	String	参数解释标签取值范围不涉及
description	String	参数解释描述取值范围不涉及
region	String	参数解释区域取值范围不涉及
author_id	String	参数解释创建人ID 取值范围不涉及
author_name	String	参数解释创建人名称取值范围不涉及
owner_id	String	参数解释责任人ID 取值范围不涉及
owner_name	String	参数解释责任人名称取值范围不涉及
parent_uri	String	参数解释父任务URI 取值范围不涉及
parent_path	String	参数解释父任务路径取值范围不涉及
origin_uri	String	参数解释源任务URI 取值范围不涉及
version_uri	String	参数解释版本URI 取值范围不涉及
branch_uri	String	参数解释分支URI 取值范围不涉及
version_name	String	参数解释版本名称取值范围不涉及
creation_date	String	参数解释创建时间取值范围不涉及
create_date_timestamp	Long	参数解释创建时间时间戳取值范围不涉及
update_time	String	参数解释更新时间取值范围不涉及
update_time_timestamp	Long	参数解释更新时间时间戳取值范围不涉及
relation_change_time	String	参数解释关联关系修改时时间取值范围不涉及
relation_change_time_timestamp	Long	参数解释关联关系修改时间时间戳取值范围不涉及
test_case_condition	String	参数解释动态任务用例过滤条件取值范围不涉及
updator_id	String	参数解释修改人Id 取值范围不涉及
updator_name	String	参数解释修改人名称取值范围不涉及
relation_changer_id	String	参数解释关联关系修改人Id 取值范围不涉及
service_type	Integer	参数解释服务类型ID 取值范围不涉及
service_type_name	String	参数解释服务类型名称取值范围不涉及
tag_list	Array of strings	参数解释标签名称集合取值范围不涉及
module_id	String	参数解释模块ID 取值范围不涉及
module_name	String	参数解释模块名称取值范围不涉及
module_path	String	参数解释模块path 取值范围不涉及
module_path_name	String	参数解释模块路径名称取值范围不涉及
release_dev	String	参数解释发布版本号取值范围不涉及
ext_param	String	参数解释扩展参数取值范围不涉及
execute_way	Integer	参数解释执行方式取值范围（1：串行，2：并行）
execute_type	Integer	参数解释执行类型取值范围（0：冒烟，1：定时）
status_code	Integer	参数解释生命周期状态Code 取值范围不涉及
status_name	String	参数解释生命周期状态名称取值范围不涉及
result_code	Integer	参数解释执行结果Code 取值范围不涉及
result_name	String	参数解释执行状态名称取值范围不涉及
execute_status_code	Integer	参数解释 Echo执行状态Code 取值范围不涉及
execute_status_name	String	参数解释 Echo执行状态名称取值范围不涉及
executor_id	String	参数解释执行人ID 取值范围不涉及
executor_name	String	参数解释执行人名称取值范围不涉及
execute_latest_time	String	参数解释最近执行时间取值范围不涉及
execute_latest_time_timestamp	Long	参数解释最近执行时间时间戳取值范围不涉及
execute_duration	String	参数解释执行时长取值范围不涉及
execute_times	Integer	参数解释执行次数取值范围不涉及
project_uuid	String	参数解释项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 取值范围不涉及
case_operation_info	CaseOperationVo object	参数解释任务关联用例信息取值范围不涉及
assign_case_num	Integer	参数解释关联用例数取值范围不涉及
finish_case_num	Integer	参数解释已完成用例数量取值范围不涉及
assign_defect_num	Integer	参数解释关联缺陷数量取值范围不涉及
task_assign_msg	String	参数解释任务关联用例变更提示信息取值范围不涉及
iterator_version_uri	String	参数解释测试套所属迭代uri，非迭代下创建的测试套返回null 取值范围不涉及
result_number_list	Array of 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)

表6 CaseOperationVo
参数	参数类型	描述
test_cases_info	Array of TaskAssignCaseVo objects	参数解释用例关联信息取值范围不涉及
set_up_cases_info	Array of TaskAssignCaseVo objects	参数解释前置用例关联信息取值范围不涉及
tear_down_cases_info	Array of TaskAssignCaseVo objects	参数解释后置用例关联信息取值范围不涉及

表7 TaskAssignCaseVo
参数	参数类型	描述
sort	Integer	参数解释排序顺序取值范围不涉及
case_uri	String	参数解释用例uri 取值范围不涉及
is_available	Integer	参数解释是否可用取值范围不涉及
test_case_name	String	参数解释用例名称取值范围不涉及
test_case_number	String	参数解释用例编号取值范围不涉及

表8 NameAndValueAndCodeVo
参数	参数类型	描述
name	String	参数解释名称取值范围不涉及
value	Integer	参数解释值取值范围不涉及
code	String	参数解释编码取值范围不涉及

表9 ApiError
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：400

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：401

**表11** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：404

**表12** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：500

**表13** 响应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

{
  "status" : "string",
  "result" : {
    "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
  },
  "error" : { },
  "request_id" : "string",
  "server_address" : "string"
}

状态码

状态码	描述
200	OK
400	Bad Request
401	Unauthorized
404	Not Found
500	Internal Server Error

错误码

请参见错误码。

父主题： 测试套管理

上一篇：版本之间引入任务

下一篇：批量创建测试套测试用例关联关系

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

查询用户已授权项目下测试任务列表

功能介绍

调用方法

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？