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

查询测试任务列表

功能介绍

查询测试任务列表

调用方法

请参见如何调用API

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

约束限制:

不涉及

取值范围:

项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字

默认取值:

不涉及

version_id

String

参数解释

版本URI

约束限制

不涉及

取值范围

11-34

默认取值

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中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

参数解释

服务类型

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

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

参数解释

排序方式

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

page_no

Integer

参数解释

当前页数

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

page_size

Integer

参数解释

每页条数

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

is_polling_query

Boolean

参数解释

是否轮询查询

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

is_query_associated_case_list

Boolean

参数解释

是否获取关联用例列表

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

plan_start_start_timestamp

Long

参数解释

计划开始时间过滤起始时间戳

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

plan_start_end_timestamp

Long

参数解释

计划开始时间过滤结束时间戳

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

plan_end_start_timestamp

Long

参数解释

计划结束时间过滤起始时间戳

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

plan_end_end_timestamp

Long

参数解释

计划结束时间过滤结束时间戳

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

expiration_status_list

Array of integers

测试套超期状态过滤,超期状态值分别为:无状态(null)、未超期(0)、即将超期(1)、已超期(2)、延期完成(3)、按期完成(4)

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

total

Integer

参数解释

总数

取值范围

起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值

value

TaskListVo object

参数解释

请求返回的数据

取值范围

不涉及

reason

String

参数解释

业务失败的提示内容

取值范围

不涉及

page_size

Integer

参数解释

业务失败的提示内容

取值范围

不涉及

page_no

Integer

参数解释

页码

取值范围

不涉及

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

参数解释

创建时间

取值范围

不涉及

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)

表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

参数解释

是否可用

取值范围

不涉及

test_case_name

String

参数解释

用例名称

取值范围

不涉及

test_case_number

String

参数解释

用例编号

取值范围

不涉及

表9 NameAndValueAndCodeVo

参数

参数类型

描述

name

String

参数解释

名称

取值范围

不涉及

value

Integer

参数解释

取值范围

不涉及

code

String

参数解释

编码

取值范围

不涉及

状态码:400

表10 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码:401

表11 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码:404

表12 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码:500

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# 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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
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 := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        Build()

    client := cloudtest.NewCloudtestClient(
        cloudtest.CloudtestClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    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

参数解释

查询测试任务列表返回

取值范围

不涉及

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档