文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试套管理/ 查询测试任务列表 - ListTasks

更新时间：2026-10-22 GMT+08:00

查看PDF

查询测试任务列表 - ListTasks

功能介绍

此接口用于查询测试任务列表，同页面测试 -> 测试执行 -> 右侧上方筛选分支，下方展示测试套列表

调用方法

请参见如何调用API。

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目UUID，项目唯一标识。获取方式请参见获取项目ID 约束限制: 不涉及取值范围: 长度等于32位，包含大小写字母、数字默认取值: 不涉及
version_id	是	String	参数解释版本URI，用于指定查询测试任务的目标版本。获取方式：从GET /v4/projects/{project_id}/iterator-infos的返回字段获取，或从GET /v1/{project_id}/branches的返回字段获取约束限制不涉及取值范围 11~34位字符，由大小写字母和数字组成默认取值不涉及

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：不涉及取值范围：字符串长度不少于1个字符，不超过100000个字符默认取值：不涉及

表3 请求Body参数
参数	是否必选	参数类型	描述
uris	否	Array of strings	参数解释测试任务URI集合，数组内每个元素为字符串类型的任务URI，格式为11-34位字母或数字约束限制不涉及取值范围不涉及默认取值不涉及
keyword	否	String	参数解释关键字查询，支持按任务名或编号模糊查询约束限制不涉及取值范围由中文字符、英文字母、数字及特殊字符组成，长度1~128个字符默认取值不涉及
tags	否	Array of strings	参数解释标签集合，数组内每个元素为字符串类型的标签，长度不超过128个字符约束限制不涉及取值范围不涉及默认取值不涉及
own	否	Boolean	参数解释是否查询当前用户的测试任务约束限制不涉及取值范围 true：查询当前用户的测试任务 false：查询所有用户的测试任务默认取值不涉及
service_type	否	Integer	参数解释: 服务类型约束限制: 不涉及取值范围: -1：全量用例 0：手工测试 1：接口自动化 7：功能自动化 8：WebUI自动化 100：自定义自动化(工厂) 11：性能自动化默认取值: 不涉及
release_dev_list	否	Array of strings	参数解释发布版本号集合，数组内每个元素为字符串类型的版本号，如1.0.4 约束限制不涉及取值范围不涉及默认取值不涉及
result_codes	否	Array of strings	参数解释结果Code集合，数组内每个元素为字符串类型的结果Code，用于按测试任务执行结果筛选约束限制不涉及取值范围不涉及默认取值不涉及
status_codes	否	Array of strings	参数解释状态Code集合，数组内每个元素为字符串类型的状态Code，用于按测试任务状态筛选约束限制不涉及取值范围不涉及默认取值不涉及
owner_ids	否	Array of strings	参数解释责任人ID集合，数组内每个元素为字符串类型的用户ID，获取方式请参见获取项目关联用户详情列表接口约束限制不涉及取值范围不涉及默认取值不涉及
executor_ids	否	Array of strings	参数解释执行者ID集合，数组内每个元素为字符串类型的用户ID，获取方式请参见获取项目关联用户详情列表接口约束限制不涉及取值范围不涉及默认取值不涉及
creator_ids	否	Array of strings	参数解释创建者ID集合，数组内每个元素为字符串类型的用户ID，获取方式请参见获取项目关联用户详情列表接口约束限制不涉及取值范围不涉及默认取值不涉及
sort_field	否	String	参数解释排序字段，支持按任务名称、任务编号等字段排序约束限制不涉及取值范围不涉及默认取值不涉及
sort_type	否	String	参数解释: 排序方式约束限制: 不涉及取值范围: ASC，升序。 DESC，降序。默认取值: 不涉及
page_no	否	Integer	参数解释当前页数约束限制不涉及取值范围 ≥1的整数默认取值 1
page_size	否	Integer	参数解释每页条数约束限制不涉及取值范围 1~100的整数默认取值不传时默认为100条
is_polling_query	否	Boolean	参数解释是否轮询查询约束限制不涉及取值范围 true：启用轮询查询 false：不启用轮询查询默认取值不涉及
is_query_associated_case_list	否	Boolean	参数解释是否获取关联用例列表约束限制不涉及取值范围 true：获取关联用例列表 false：不获取关联用例列表默认取值不涉及
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	参数解释测试套超期状态过滤，数组内每个Integer元素的含义：null表示无状态，0表示未超期，1表示即将超期，2表示已超期，3表示延期完成，4表示按期完成约束限制不涉及

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
total	Integer	参数解释测试任务总数。当起始记录数大于实际总条数时，值为0，分页请求才有此值取值范围大于等于0
value	TaskListVo object	参数解释请求返回的数据取值范围不涉及
reason	String	参数解释业务失败的提示内容取值范围不涉及
page_size	Integer	参数解释分页大小取值范围大于0
page_no	Integer	参数解释页码取值范围大于0
has_more	Boolean	参数解释是否有更多取值范围不涉及

表5 TaskListVo
参数	参数类型	描述
tasks	Array of TaskVo objects	参数解释测试任务集合取值范围不涉及
running_count	Integer	参数解释正在执行任务数取值范围不涉及

表6 TaskVo
参数	参数类型	描述
uri	String	参数解释测试任务URI 取值范围不涉及
name	String	参数解释测试任务名称取值范围不涉及
stage	String	参数解释测试阶段取值范围不涉及
number	String	参数解释编号取值范围不涉及
tags	String	参数解释标签取值范围不涉及
description	String	参数解释描述取值范围不涉及
region	String	参数解释区域取值范围不涉及
author_id	String	参数解释创建人ID 取值范围不涉及
author_name	String	参数解释创建人名称取值范围不涉及
owner_id	String	参数解释责任人ID 取值范围不涉及
owner_name	String	参数解释责任人名称取值范围不涉及
parent_uri	String	参数解释父任务URI 取值范围不涉及
parent_path	String	参数解释父任务路径取值范围不涉及
origin_uri	String	参数解释源任务URI 取值范围不涉及
version_uri	String	参数解释版本URI 取值范围不涉及
branch_uri	String	参数解释分支URI 取值范围不涉及
version_name	String	参数解释版本名称取值范围不涉及
creation_date	String	参数解释创建时间，格式为yyyy-MM-dd HH:mm:ss 取值范围不涉及
create_date_timestamp	Long	参数解释创建时间的时间戳，单位为毫秒取值范围不涉及
update_time	String	参数解释更新时间，格式为yyyy-MM-dd HH:mm:ss 取值范围不涉及
update_time_timestamp	Long	参数解释更新时间的时间戳，单位为毫秒取值范围不涉及
relation_change_time	String	参数解释关联关系修改时间，格式为yyyy-MM-dd HH:mm:ss 取值范围不涉及
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	参数解释执行时长，格式为HH:mm:ss（时:分:秒）取值范围不涉及
execute_times	Integer	参数解释执行次数取值范围不涉及
project_uuid	String	参数解释项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 取值范围固定长度为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)

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

表8 TaskAssignCaseVo
参数	参数类型	描述
sort	Integer	参数解释排序顺序取值范围不涉及
case_uri	String	参数解释用例uri 取值范围不涉及
is_available	Integer	参数解释用例是否可用取值范围 0：不可用 1：可用
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	参数解释服务类型取值范围不涉及

表9 NameAndIdVo
参数	参数类型	描述
id	String	参数解释 NameAndIdVo对象的唯一标识ID 取值范围不涉及
name	String	参数解释 NameAndIdVo对象的显示名称取值范围不涉及

**表10** NameAndValueAndCodeVo
参数	参数类型	描述
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

{
  "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的代码示例页签，可生成自动对应的SDK代码示例。

状态码

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

错误码

请参见错误码。

父主题： 测试套管理

上一篇：更新用例执行信息 - UpdateTaskCasesExecutionInfo

下一篇：获取全量测试套关联用例详情 - ShowTaskAssignCasesFiveV5