# 查询需求下的用例列表 - ShowTestCasesByIssue #### 功能介绍 此接口用于查询指定需求下的用例列表,同页面测试-\> 测试用例 -\> 左侧树状图选择需求 -\> 选中需求查询需求下的用例 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/{project_id}/issues/{issue_id}/testcases/batch-query 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释** 项目UUID **约束限制** 32位字母及数字 **取值范围** 项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **默认取值** 不涉及 | | issue_id | 是 | String | 需求id **获取方法**： 从req系统获取 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | page_no | 否 | Integer | **参数解释** 页码 **约束限制** 说明： 0 的正整数 **取值范围** 大于0小于100 **默认取值** 不涉及 | | page_size | 否 | Integer | **参数解释** 每页数量 **约束限制** 说明： 0 的正整数 **取值范围** 大于0小于20000 **默认取值** 不涉及 | | sort_field | 否 | String | 排序字段 | | sort_type | 否 | String | **参数解释**: 排序方式 **约束限制**: 不涉及 **取值范围**: - ASC，升序。 - DESC，降序。 **默认取值**: 不涉及 | | version_uri | 否 | String | **参数解释** 版本uri **约束限制** 11-34位字母及数字 **取值范围** 11-34位字母及数字 **默认取值** 不涉及 | | relate_type | 否 | String | **参数解释**: 关联关系类型 **约束限制**: 不涉及 **取值范围**: - bug，缺陷。 - requirement，需求。 **默认取值**: 不涉及 | | key_word | 否 | String | **参数解释** 关键字 **约束限制** 字符串 **取值范围** 128位以内的字符串 **默认取值** 不涉及 | | rank_ids | 否 | Array of strings | **参数解释** 用例等级ID集合 **约束限制** 不涉及 **取值范围** 集合内的数据可传0,1,2,3,4 **默认取值** 不涉及 | | result_codes | 否 | Array of strings | **参数解释** 结果Code集合 **约束限制** 不涉及 **取值范围** 可传1-5位的数字 **默认取值** 不涉及 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | [QueryTestCasesByIssueVo] object | 请求返回的数据 | 表4QueryTestCasesByIssueVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | case_status_map | Map\ | 用例状态 | | new_create | Integer | 新建态 | | designing | Integer | 设计态 | | finished | Integer | 完成态 | | testing | Integer | 测试态 | | test_case_num | Integer | 需求关联的用例数量 | | testcases | Array of [TestCaseVo] objects | 用例详情 | | total_count | Integer | 用例总数 | 表5TestCaseVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | **参数解释** 用例ID **取值范围** 不涉及 | | version_uri | String | **参数解释** 版本URI **取值范围** 不涉及 | | parent_uri | String | **参数解释** 父资源URI **取值范围** 不涉及 | | parent_path | String | **参数解释** 父资源路径 **取值范围** 不涉及 | | type | String | **参数解释** 资源类型 **取值范围** 不涉及 | | creation_version_uri | String | **参数解释** 创建版本URI **取值范围** 不涉及 | | last_modifier | String | **参数解释** 最后修改人 **取值范围** 不涉及 | | last_modified | String | **参数解释** 最后修改时间 **取值范围** yyyy-MM-dd HH:mm:ss | | last_change_time | String | **参数解释** 最后变更时间 **取值范围** yyyy-MM-dd HH:mm:ss | | number | String | **参数解释** 用例编号 **取值范围** 不涉及 | | name | String | **参数解释** 用例名称 **取值范围** 不涉及 | | rank | String | **参数解释** 用例等级 **取值范围** 不涉及 | | case_type | Integer | **参数解释** 用例类型 **取值范围** 不涉及 | | platform_type | Integer | **参数解释** 执行平台类型 **取值范围** 不涉及 | | service_type | Integer | **参数解释** 服务类型 **取值范围** 不涉及 | | test_step | String | **参数解释** 测试步骤 **取值范围** 不涉及 | | expect_output | String | **参数解释** 期望结果 **取值范围** 不涉及 | | auto_type | Integer | **参数解释** 自动化类型 **取值范围** 非自动化:0, 是自动化:1 | | to_be_auto_exec | Integer | **参数解释** 被自动化执行 **取值范围** 不涉及 | | dr_relation_id | String | **参数解释** 工作项id **取值范围** 不涉及 | | automatically_executed | Integer | **参数解释** 是否被自动化执行 **取值范围** 不涉及 | | is_contract_testcase | Integer | **参数解释** 是否是契约用例 **取值范围** 0:表示非契约用例, 1：表示契约用例 | | time_cost | Double | **参数解释** 总共耗时 **取值范围** 不涉及 | | last_exe_author | String | **参数解释** 最后一次执行用户 **取值范围** 不涉及 | | status_code | String | **参数解释** 状态ID **取值范围** 不涉及 | | result_code | String | **参数解释** 结果Code **取值范围** 不涉及 | | status_name | String | **参数解释** 状态名称 **取值范围** 不涉及 | | author | String | **参数解释** 创建人名称 **取值范围** 不涉及 | | author_id | String | **参数解释** 创建人ID **取值范围** 不涉及 | | region | String | **参数解释** 逻辑region **取值范围** 不涉及 | | owner | String | **参数解释** 处理人名称 **取值范围** 不涉及 | | issue_id | String | **参数解释** 工作项id **取值范围** 不涉及 | | issue_tracker_id | String | **参数解释** 工作项类型id **取值范围** 不涉及 | | issue_assign_status | String | **参数解释** 工作项分配状态 **取值范围** 不涉及 | | issue_name | String | **参数解释** 工作项名称 **取值范围** 不涉及 | | issue_design_owner | String | **参数解释** 工作项设计责任人 **取值范围** 不涉及 | | issue_design_owner_d | String | **参数解释** 工作项设计责任人id **取值范围** 不涉及 | | tracker_name | String | **参数解释** 工作项类型名称 **取值范围** 不涉及 | | defect_list | Array of [NameAndIdVo] objects | **参数解释** 缺陷列表 **取值范围** 不涉及 | | result_name | String | **参数解释** 结果名称 **取值范围** 不涉及 | | execute_latest_time | String | **参数解释** 最后执行时间 **取值范围** yyyy-MM-dd HH:mm:ss | | execute_duration | String | **参数解释** 执行时长 **取值范围** 不涉及 | | is_keyword | Integer | **参数解释** 是否关键用例 **取值范围** 不涉及 | | project_uuid | String | **参数解释** 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围** 不涉及 | | test_type | String | **参数解释**: 测试类型 **取值范围**: - 1，功能性测试。 - 2，兼容性测试。 - 4，性能测试。 - 15，易用性测试。 - 22，可靠性测试。 - 14，安全性测试。 - 21，可服务性测试。 | | creation_date | String | **参数解释** 创建时间 **取值范围** 不涉及 | 表6NameAndIdVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | ID | | name | String | 名称 | **状态码：400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：401** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：404** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | **状态码：500** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** : 业务失败的错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释** : 业务失败的提示内容 **取值范围**: 不涉及 | #### 请求示例 ``` post https://{endpoint}/v4/projects/f3087a82b44744c29a1bd69ab6ada154/issues/1134703430181982208/testcases/batch-query { "page_no" : 1, "page_size" : 100, "relate_type" : "bug", "sort_type" : "DESC" } ``` #### 响应示例 **状态码：200** OK ``` { "value" : { "case_status_map" : { "完成" : 1 }, "new_create" : 0, "designing" : 0, "finished" : 1, "testing" : 0, "test_case_num" : 1, "testcases" : [ { "uri" : "v90410b5o5ce22a7", "type" : "TestCase", "author" : "sec_admin——nich", "name" : "cx_2995", "rank" : 2, "region" : "roma-dev-2-arm", "owner" : "", "version_uri" : "v90200010aelu5om", "parent_uri" : "v90200010aelu5om", "parent_path" : "/407ac57de7ea44d28e47293a2b9cf15c/v90200010aelu5om/", "creation_version_uri" : "v90100010b5nubs0", "last_modifier" : "sec_admin——nich", "last_modified" : "2025-05-29 10:25:40", "last_change_time" : "2025-03-21 18:25:43", "creation_date" : "2025-03-21 18:25:04", "author_id" : "2ce06fffb4634271a377c1cd7c429704", "number" : "7417", "case_type" : 0, "platform_type" : 0, "service_type" : 0, "test_type" : 1, "test_step" : "[\"\"]", "expect_output" : "[\"\"]", "auto_type" : 0, "to_be_auto_exec" : 0, "automatically_executed" : 0, "is_contract_testcase" : 0, "time_cost" : 0, "last_exe_author" : "2ce06fffb4634271a377c1cd7c429704", "status_code" : "7", "result_code" : "1", "execute_latest_time" : "2025-05-29 10:25:40", "execute_duration" : "00:00:00.000", "is_keyword" : 0, "project_uuid" : "407ac57de7ea44d28e47293a2b9cf15c", "issue_id" : "[\"1134703430181982208\"]", "issue_tracker_id" : "[\"3\"]", "issue_assign_status" : "[null]", "issue_name" : "[\"史蒂文\"]", "issue_design_owner" : "[null]", "issue_design_owner_d" : "[null]", "tracker_name" : "[\"Bug\"]", "defect_list" : [ ], "result_name" : "失败", "status_name" : "完成" } ], "total_count" : 1 } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。