文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 用例关联关系管理/ 查询用例关联的测试任务列表
更新时间：2025-06-26 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询用例关联的测试任务列表

功能介绍

查询用例关联的测试任务列表

调用方法

请参见如何调用API。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

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

约束限制:

不涉及

取值范围:

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

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

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

约束限制：

必传。

取值范围：

字符串长度不少于1，不超过10万。

默认取值：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

page_no

否

Integer

参数解释

页码

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

page_size

否

Integer

参数解释

每页数量

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

start_index

否

Integer

参数解释

起始位

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

end_index

否

Integer

参数解释

结束位

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

key_word

否

String

参数解释

关键字

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

test_case_uris

否

Array of strings

参数解释

用例uri列表

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

iterator_uri

否

String

参数解释

测试计划uri

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

related_case_uris

Array of strings

参数解释

关联的用例uris

取值范围

不涉及

not_related_case_uris

Array of strings

参数解释

未关联的用例uris

取值范围

不涉及

case_task_info

Array of RelateTaskTestCasesVo objects

参数解释

用例及任务信息

取值范围

不涉及
表5 RelateTaskTestCasesVo

参数

参数类型

描述

test_case_num

String

参数解释

用例编号

取值范围

不涉及

test_case_name

String

参数解释

用例名

取值范围

不涉及

test_case_uri

String

参数解释

用例uri

取值范围

不涉及

task_uri

String

参数解释

任务uri

取值范围

不涉及

task_name

String

参数解释

任务名

取值范围

不涉及

task_num

String

参数解释

任务编号

取值范围

不涉及

task_creator

String

参数解释

任务创建人

取值范围

不涉及

状态码：400

表6 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码：401

表7 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码：404

表8 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码：500

表9 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

请求示例

post https://{endpoint}/GT3KServer/v4/dc3f9aa646ad4707831080d3fcce474d/testcases/tasks/batch-query

{
  "page_no" : 1,
  "page_size" : 10,
  "key_word" : "",
  "test_case_uris" : [ "v92s00010db20aj6" ],
  "iterator_uri" : ""
}

响应示例

状态码：200

OK

{
  "related_case_uris" : [ "v92s00010db20aj6" ],
  "not_related_case_uris" : [ ],
  "case_task_info" : [ {
    "test_case_num" : "120",
    "test_case_name" : "推送误报信息处理",
    "test_case_uri" : "v92s00010db20aj6",
    "task_uri" : "v92s00010db20ank",
    "task_name" : "第一批次执行",
    "task_num" : "108",
    "task_creator" : "paas_testplan_g30030845_01"
  } ]
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

相关文档