# 获取测试套关联用例详情 - ShowTaskAssignCasesFour #### 功能介绍 此接口用于查询测试套下已关联的用例,同页面 测试 -\> 测试执行 -\> 点击测试套详情 -\> 显示关联的用例 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/{project_id}/tasks/{task_uri}/testcases/batch-query 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | task_uri | 是 | String | 任务uri | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | stage | 否 | Integer | 测试用例在任务中的阶段 | | owners | 否 | Array of strings | 处理人过滤数组 | | page_no | 否 | Integer | 页码 | | page_size | 否 | Integer | 页数量，取值范围\[1,1000\] | | results | 否 | Array of strings | 结果过滤 | | status | 否 | Array of strings | 状态过滤 | | version_uri | 否 | String | 分支/迭代uri | | release_dev | 否 | String | 任务版本过滤条件，影响关联任务的结果查询，查询当前任务版本下的用例最新结果 | | sort_field | 否 | String | 排序字段 | | sort_type | 否 | String | **参数解释**: 排序方法 **约束限制**: 不涉及 **取值范围**: - ASC，升序。 - DESC，降序。 **默认取值**: 不涉及 | | feature_uri | 否 | String | 特性目录URI | | task_result_uri | 否 | String | 测试套结果uri | | rank_ids | 否 | Array of integers | 用例等级ID集合 | | key_word | 否 | String | 关键字 | | issue_id | 否 | String | 需求id | | associated_issue | 否 | Boolean | 是否关联需求（null：不限，false：未关联，true：已关联） | | select_all_pages | 否 | Boolean | 是否全选所有页（null：不全选，false：不全选，true：全选），用于任务批量执行结果功能，只返回用例uri，不返回其他信息 | | is_available | 否 | Boolean | 用例是否可用 | | is_script_exist | 否 | Boolean | 用例脚本字段是否有值 | | is_contain_child | 否 | Boolean | 是否包含子目录,默认为true | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | Array of [TaskAssignCaseDetailVo] objects | 获取测试套关联用例详情返回参数 | 表4TaskAssignCaseDetailVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | 关联关系uri | | sort | Integer | 排序顺序 | | owner | String | 责任人id | | stage | Integer | 测试阶段 | | project_id | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | task_uri | String | 任务uri | | update_time | String | 测试套关联用例的更新时间 | | updator_name | String | 测试套关联用例的更新人 | | updator | String | 测试套关联用例的更新人id | | result_execute_time | String | 结果的最后修改时间 | | result_executor_name | String | 结果的最后修改人名称 | | result_executor_id | String | 结果的最后修改人id | | case_uri | String | 用例uri | | is_available | Integer | 是否可用 | | test_case_name | String | 用例名称 | | feature_uri | String | 用例目录Uri | | test_case_number | String | 用例编号 | | svn_script_path | String | 脚本路径 | | status_code | String | 状态 | | status_name | String | 状态名称 | | result_code | String | 结果id | | result_name | String | 结果名称 | | owner_name | String | 责任人名称 | | execute_latest_time | String | 最新执行时间 | | execute_duration | String | 执行时长 | | is_keyword | Integer | 是否是关键用例 | | net_work_script_name | String | 脚本名称 | | rank_id | Integer | 用例等级 | | remark | String | 描述 | **状态码：400** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：401** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：404** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：500** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | #### 请求示例 ``` post https://{endpoint}/v4/projects/f3087a82b44744c29a1bd69ab6ada154/tasks/v90100010gmi4h0j/testcases/batch-query { "page_no" : 1, "page_size" : 15, "results" : [ ], "status" : [ ], "version_uri" : "v90200010aelu5om", "owners" : [ ], "rank_ids" : [ ] } ``` #### 响应示例 **状态码：200** OK ``` { "value" : [ { "uri" : "v90100010gmi4sgs", "sort" : 1, "owner" : "", "stage" : 1, "project_id" : "407ac57de7ea44d28e47293a2b9cf15c", "task_uri" : "v90100010gmi4h0j", "update_time" : "2025-05-29 10:25:40", "updator_name" : "sec_admin——nich", "updator" : "2ce06fffb4634271a377c1cd7c429704", "case_uri" : "v90410b5o5ce22a7", "is_available" : 1, "test_case_name" : "cx_2995", "test_case_number" : "7417", "status_code" : "7", "status_name" : "完成", "result_code" : "1", "result_name" : "失败", "is_keyword" : 0, "rank_id" : 2 }, { "uri" : "v90110gmi4sgsf2e", "sort" : 2, "owner" : "", "stage" : 1, "project_id" : "407ac57de7ea44d28e47293a2b9cf15c", "task_uri" : "v90100010gmi4h0j", "update_time" : "2025-05-29 10:25:39", "updator_name" : "sec_admin——nich", "updator" : "2ce06fffb4634271a377c1cd7c429704", "case_uri" : "v90200010gmhoo73", "is_available" : 1, "test_case_name" : "sdw", "test_case_number" : "7421", "status_code" : "0", "status_name" : "新建", "result_name" : "未执行", "is_keyword" : 0, "rank_id" : 2 } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。