文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试执行任务管理/ 批量查询子任务用例 - ListSubTestCaseByConditionsUsing
更新时间:2026-10-22 GMT+08:00
分享

批量查询子任务用例 - ListSubTestCaseByConditionsUsing

功能介绍

批量查询子任务用例

调用方法

请参见如何调用API。

URI

POST /v1/projects/{service_id}/testsuite/results/cases

表1 路径参数

参数

是否必选

参数类型

描述

service_id

是

String

服务id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

create_user

否

String

用例创建者

endTime

否

Long

用例结束时间

keyWord

否

String

模糊查询关键字

location_id

否

String

执行机区域ID

more

否

Boolean

查询结果是否还有更多数据的标志

page_num

否

Integer

分页时页码

page_size

否

Integer

分页时每页大小

pid

否

String

告警策略选择失败后重试时有值

results

否

Array of integers

cloudTest任务执行结果列表

sortBy

否

String

排序字段

stage

否

Integer

用例所处的阶段 0:前置, 1:测试用例 2:后置用例

startTime

否

Long

用例开始时间

state

否

String

状态

subtask_ids

否

Array of strings

子任务ID列表

subtask_id

否

String

子任务ID

suiteType

否

Integer

商用测试套类型

task_id

否

String

任务ID

task_ids

否

Array of strings

任务ID列表

taskTypeId

否

String

任务类型

taskid

否

String

任务ID

test_service_id

否

String

服务ID

testcase_id

否

String

用例ID

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

end_row

Long

当前页面最后一个元素在数据库中的行号

has_next_page

Boolean

是否有下一页

has_previous_page

Boolean

是否有前一页

is_first_page

Boolean

是否为第一页

is_last_page

Boolean

是否为最后一页

list

Array of objects

返回结果

navigateFirstPage

Integer

导航条上的第一页

navigateLastPage

Integer

导航条上的最后一页

navigate_pages

Integer

导航页码数

navigatepageNums

Array of integers

所有导航页号

next_page

Integer

下一页

page_num

Integer

当前页

page_size

Integer

每页的数量

pages

Integer

总页数

pre_page

Integer

前一页

size

Integer

当前页的数量

start_row

Long

当前页面第一个元素在数据库中的行号

total

Long

总条数

状态码:201

无

状态码:401

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

error_msg

String

错误原因

状态码:403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

error_msg

String

错误原因

状态码:404

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误编码

error_msg

String

错误原因

请求示例

post https://{endpoint}/v1/projects/4858a39d9861476ca2cbc71db0d5db2e/testsuite/results/cases

{
  "create_user" : "zx12513135",
  "location_id" : "021313002",
  "more" : true,
  "page_num" : 1,
  "page_size" : 10,
  "pid" : "168263031256",
  "stage" : 1,
  "state" : "gamma",
  "subtask_ids" : [ "165121313" ],
  "subtask_id" : "3516541320",
  "suiteType" : 0,
  "task_id" : "cfasf241352136",
  "task_ids" : [ "casd321032" ],
  "taskTypeId" : "ads351352",
  "taskid" : "csZc2s1032",
  "test_service_id" : "fcas1df2s3a1",
  "testcase_id" : "cvaszcv163sd1"
}

响应示例

状态码:200

pageNum: 1
pageSize: 15
sortBy: startTime
suiteType: 1
subtaskId: da3ee5c098044a42924b491a49e1e72a
taskTypeId: '2'
taskId: v92u00011gacv6j8
results: []
startTime: 1782437202382
stage: 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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
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.*;

import java.util.List;
import java.util.ArrayList;

public class ListSubTestCaseByConditionsUsingSolution {

    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();
        ListSubTestCaseByConditionsUsingRequest request = new ListSubTestCaseByConditionsUsingRequest();
        request.withServiceId("{service_id}");
        SubTaskCaseQuery body = new SubTaskCaseQuery();
        List<String> listbodyTaskIds = new ArrayList<>();
        listbodyTaskIds.add("casd321032");
        List<String> listbodySubtaskIds = new ArrayList<>();
        listbodySubtaskIds.add("165121313");
        body.withTestcaseId("cvaszcv163sd1");
        body.withTestServiceId("fcas1df2s3a1");
        body.withTaskTypeId("ads351352");
        body.withTaskIds(listbodyTaskIds);
        body.withTaskId("cfasf241352136");
        body.withSuiteType(0);
        body.withSubtaskId("3516541320");
        body.withSubtaskIds(listbodySubtaskIds);
        body.withState("gamma");
        body.withStage(1);
        body.withPid("168263031256");
        body.withPageSize(10);
        body.withPageNum(1);
        body.withMore(true);
        body.withLocationId("021313002");
        body.withCreateUser("zx12513135");
        request.withBody(body);
        try {
            ListSubTestCaseByConditionsUsingResponse response = client.listSubTestCaseByConditionsUsing(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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
# 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 = ListSubTestCaseByConditionsUsingRequest()
        request.service_id = "{service_id}"
        listTaskIdsbody = [
            "casd321032"
        ]
        listSubtaskIdsbody = [
            "165121313"
        ]
        request.body = SubTaskCaseQuery(
            testcase_id="cvaszcv163sd1",
            test_service_id="fcas1df2s3a1",
            task_type_id="ads351352",
            task_ids=listTaskIdsbody,
            task_id="cfasf241352136",
            suite_type=0,
            subtask_id="3516541320",
            subtask_ids=listSubtaskIdsbody,
            state="gamma",
            stage=1,
            pid="168263031256",
            page_size=10,
            page_num=1,
            more=True,
            location_id="021313002",
            create_user="zx12513135"
        )
        response = client.list_sub_test_case_by_conditions_using(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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
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.ListSubTestCaseByConditionsUsingRequest{}
	request.ServiceId = "{service_id}"
	var listTaskIdsbody = []string{
        "casd321032",
    }
	var listSubtaskIdsbody = []string{
        "165121313",
    }
	testcaseIdSubTaskCaseQuery:= "cvaszcv163sd1"
	testServiceIdSubTaskCaseQuery:= "fcas1df2s3a1"
	taskTypeIdSubTaskCaseQuery:= "ads351352"
	taskIdSubTaskCaseQuery:= "cfasf241352136"
	suiteTypeSubTaskCaseQuery:= int32(0)
	subtaskIdSubTaskCaseQuery:= "3516541320"
	stateSubTaskCaseQuery:= "gamma"
	stageSubTaskCaseQuery:= int32(1)
	pidSubTaskCaseQuery:= "168263031256"
	pageSizeSubTaskCaseQuery:= int32(10)
	pageNumSubTaskCaseQuery:= int32(1)
	moreSubTaskCaseQuery:= true
	locationIdSubTaskCaseQuery:= "021313002"
	createUserSubTaskCaseQuery:= "zx12513135"
	request.Body = &model.SubTaskCaseQuery{
		TestcaseId: &testcaseIdSubTaskCaseQuery,
		TestServiceId: &testServiceIdSubTaskCaseQuery,
		TaskTypeId: &taskTypeIdSubTaskCaseQuery,
		TaskIds: &listTaskIdsbody,
		TaskId: &taskIdSubTaskCaseQuery,
		SuiteType: &suiteTypeSubTaskCaseQuery,
		SubtaskId: &subtaskIdSubTaskCaseQuery,
		SubtaskIds: &listSubtaskIdsbody,
		State: &stateSubTaskCaseQuery,
		Stage: &stageSubTaskCaseQuery,
		Pid: &pidSubTaskCaseQuery,
		PageSize: &pageSizeSubTaskCaseQuery,
		PageNum: &pageNumSubTaskCaseQuery,
		More: &moreSubTaskCaseQuery,
		LocationId: &locationIdSubTaskCaseQuery,
		CreateUser: &createUserSubTaskCaseQuery,
	}
	response, err := client.ListSubTestCaseByConditionsUsing(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

更多

更多编程语言的SDK代码示例,请参见API Explorer的代码示例页签,可生成自动对应的SDK代码示例。

状态码

状态码

描述

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码。

相关文档