
# 查询需求下的用例列表 - ListTestCasesByIssue
#### 功能介绍
此接口用于查询需求下的用例列表,同页面 测试 -\> 测试用例 -\> 左侧列表点击需求 -\> 选择一条需求展开 -\> 查看需求下关联的用例
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /testrelation/v4/{project_id}/issues/{issue_id}/testcases/batch-query
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **约束限制**: 字符串类型，长度32位字符 **取值范围**: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 **默认取值**: 不涉及 |
| issue_id   | 是    | String | **参数解释** 需求id **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 **获取方法**： 从req系统获取                                                       |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 必传。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 |
   
表3请求Body参数 
| 参数           | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| page_no      | 是    | Integer          | **参数解释** 页码 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                          |
| page_size    | 是    | Integer          | **参数解释** 每页数量 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                        |
| sort_field   | 否    | String           | **参数解释** 排序字段 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                        |
| sort_type    | 否    | String           | **参数解释**: 排序类型 **约束限制**: 不涉及 **取值范围**: - ASC，升序。   - DESC，降序。    **默认取值**: 不涉及          |
| version_uri  | 否    | String           | **参数解释** 版本uri **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                       |
| relate_type  | 否    | String           | **参数解释**: 关联关系类型 **约束限制**: 不涉及 **取值范围**: - bug，缺陷。   - requirement，需求。    **默认取值**: 不涉及 |
| key_word     | 否    | String           | **参数解释** 关键字 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                         |
| rank_ids     | 否    | Array of strings | **参数解释** 用例等级ID集合 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                    |
| result_codes | 否    | Array of strings | **参数解释** 结果Code集合 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                    |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数    | 参数类型                                                                                      | 描述                                                                                                                                                |
|:---|:---|:---|
| value | [QueryTestCasesByIssueVo] object | **参数解释** 返回值 **取值范围** 不涉及 |
   
 表5QueryTestCasesByIssueVo 
| 参数              | 参数类型                                                                      | 描述                                                                                                                                                      |
|:---|:---|:---|
| case_status_map | Map\<String,Integer\>                                                     | **参数解释** 用例状态 **取值范围** 不涉及      |
| new_create      | Integer                                                                   | **参数解释** 新建态 **取值范围** 不涉及       |
| designing       | Integer                                                                   | **参数解释** 设计态 **取值范围** 不涉及       |
| finished        | Integer                                                                   | **参数解释** 完成态 **取值范围** 不涉及       |
| testing         | Integer                                                                   | **参数解释** 测试态 **取值范围** 不涉及       |
| test_case_num   | Integer                                                                   | **参数解释** 需求关联的用例数量 **取值范围** 不涉及 |
| testcases       | Array of [TestCaseVo] objects | **参数解释** 用例详情 **取值范围** 不涉及      |
| total_count     | Integer                                                                   | **参数解释** 用例总数 **取值范围** 不涉及      |
   
 表6TestCaseVo 
| 参数                      | 参数类型                                                                    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|
| uri                     | String                                                                  | **参数解释** 用例URI **取值范围** 11-34位字母及数字                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| type                    | String                                                                  | **参数解释**: 资源类型 **取值范围**: - TestCase，用例。   - Task，任务。   - TestVersion，分支。   - IteratorTestCase，迭代用例。                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| author                  | String                                                                  | **参数解释** 创建人 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| name                    | String                                                                  | **参数解释** 名称 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| rank                    | Integer                                                                 | **参数解释** 用例等级 **取值范围** - 0，Priority 0。   - 1，Priority 1。   - 2，Priority 2。   - 3，Priority 3。   - 4，Priority 4。                                                                                                                                                                                                                                                                                                     |
| preparation             | String                                                                  | **参数解释** 前置条件 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| remark                  | String                                                                  | **参数解释** 备注 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| stage                   | String                                                                  | **参数解释** 测试阶段 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| activity                | String                                                                  | **参数解释** 测试类型 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| keywords                | String                                                                  | **参数解释** 关键词 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| market                  | String                                                                  | **参数解释** apitest标记是否代码已提交 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| designer                | String                                                                  | **参数解释** 设计者 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| tags                    | String                                                                  | **参数解释** 标签 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| execute_parameter       | String                                                                  | **参数解释** 执行参数 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| region                  | String                                                                  | **参数解释** 逻辑region **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| owner                   | String                                                                  | **参数解释** 处理人id，IteratorTestCase字段 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| last_modifier           | String                                                                  | **参数解释** 最后修改人 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| last_modified           | String                                                                  | **参数解释** 最后修改时间 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| last_modified_timestamp | Long                                                                    | **参数解释** 修改时间时间戳 **取值范围** 时间戳格式，单位为毫秒                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| last_change_time        | String                                                                  | **参数解释** 最后变更时间 **取值范围** 时间格式为"yyyy-MM-dd HH:mm:ss"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| version_uri             | String                                                                  | **参数解释** 版本URI **取值范围** 11-34位字母及数字                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| origin_uri              | String                                                                  | **参数解释** 源资源URI **取值范围** 11-34位字母及数字                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| parent_uri              | String                                                                  | **参数解释** 父资源URI **取值范围** 11-34位字母及数字                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| parent_path             | String                                                                  | **参数解释** 父资源路径 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| creation_version_uri    | String                                                                  | **参数解释** 创建版本URI **取值范围** 11-34位字母及数字                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| creation_date           | String                                                                  | **参数解释** 创建时间 **取值范围** 时间格式为"yyyy-MM-dd HH:mm:ss"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| creation_date_timestamp | Long                                                                    | **参数解释** 创建时间时间戳 **取值范围** 时间戳格式，单位为毫秒                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| author_id               | String                                                                  | **参数解释** 创建人ID **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| author_name             | String                                                                  | **参数解释** 创建人名称 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| comment                 | String                                                                  | **参数解释** 备注 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| number                  | String                                                                  | **参数解释** 编号 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| case_type               | Integer                                                                 | **参数解释**: 用例类型 **取值范围**: - 0，手工测试。   - 1，接口自动化。   - 2，性能用例。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| platform_type           | Integer                                                                 | **参数解释** 执行平台类型 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| service_type            | Integer                                                                 | **参数解释**: 服务类型 **取值范围**: - -1，全量用例。   - 0，手工测试。   - 1，接口自动化。   - 7，功能自动化。   - 8，WebUI自动化。   - 100，自定义自动化(工厂)。   - 11，性能自动化。    |
| service_type_name       | String                                                                  | **参数解释** 服务类型名称 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| test_type               | Integer                                                                 | **参数解释**: 测试类型 **取值范围**: - 1，性能。   - 2，安全。   - 3，功能。   - 4，韧性可靠性。   - 5，过载场景。                                                                                                                                                                                                                                                                                                                                      |
| test_type_name          | String                                                                  | **参数解释** 测试类型名称 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| design_note             | String                                                                  | **参数解释** 设计描述 **取值范围** 长度1-128字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| test_step               | String                                                                  | **参数解释** 测试步骤 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| expect_output           | String                                                                  | **参数解释** 期望结果 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| env_type                | String                                                                  | **参数解释** 测试环境类型 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| exe_platform            | String                                                                  | **参数解释** 执行平台 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| testcase_project        | String                                                                  | **参数解释** 测试工程 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| svn_script_path         | String                                                                  | **参数解释** 脚本路径 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| map_restrict            | String                                                                  | **参数解释** 约束条件 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| network_script_name     | String                                                                  | **参数解释** 网络脚本名 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| auto_type               | Integer                                                                 | **参数解释**: 自动化类型 **取值范围**: - 0，非自动化。   - 1，是自动化。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| to_be_auto_exec         | Integer                                                                 | **参数解释** 被自动化执行 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| last_result             | String                                                                  | **参数解释** 最后一次结果 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| last_result_uri         | String                                                                  | **参数解释** 最后一次结果Uri **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| feature_uri             | String                                                                  | **参数解释** 目录Uri **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| feature_name            | String                                                                  | **参数解释** 目录名称 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| interface_name          | String                                                                  | **参数解释** 测试接口名 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| snp_no                  | String                                                                  | **参数解释** 网络问题ID **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| dr_relation_id          | 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 [NameAndId] objects | **参数解释** 缺陷列表 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| result_name             | String                                                                  | **参数解释** 结果名称 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| test_base_num           | String                                                                  | **参数解释** 测试基数 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| automatically_executed  | Integer                                                                 | **参数解释** 是否被自动化执行 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| first_execute_time      | String                                                                  | **参数解释** 第一次执行时间 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| detect_type             | String                                                                  | **参数解释** 检测类型 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| execute_param           | String                                                                  | **参数解释** 执行参数 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| test_feature            | String                                                                  | **参数解释** 分析领域 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| is_contract_testcase    | Integer                                                                 | **参数解释** 是否是契约用例 **取值范围** 0:表示非契约用例, 1：表示契约用例                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| time_cost               | Double                                                                  | **参数解释** 总共耗时 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| be_auto_type_time       | String                                                                  | **参数解释** 记录用例由非自动化变为自动化类型的时间 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| compare_number          | String                                                                  | **参数解释** 配对用例编号 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| scene_flag              | String                                                                  | **参数解释** 场景标识 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| base_flag               | String                                                                  | **参数解释** 场景标识 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| para_validator          | String                                                                  | **参数解释** 区别是否从yaml中生成的用例 **取值范围** 默认false                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| knet_node_id            | String                                                                  | **参数解释** knet节点id **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| last_exe_author         | String                                                                  | **参数解释** 最后一次执行用户 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| cloud_carrier           | String                                                                  | **参数解释** 运营商 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| market_place            | String                                                                  | **参数解释** 应用市场 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| test_mind_id            | String                                                                  | **参数解释** 脑图id **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| test_mind_url           | String                                                                  | **参数解释** 脑图url **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| commit_url              | String                                                                  | **参数解释** git提交url **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| test_pattern_number     | String                                                                  | **参数解释** 测试模式编号 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| test_factor_number      | String                                                                  | **参数解释** 测试因子编号 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| status_code             | String                                                                  | **参数解释** 状态Code **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| result_code             | String                                                                  | **参数解释** 结果Code **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| release_id              | String                                                                  | **参数解释** 迭代ID **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| label_id                | String                                                                  | **参数解释** 标签ID **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| labels                  | String                                                                  | **参数解释** 用例标签名称列表 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| status_name             | String                                                                  | **参数解释** 状态名称 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| module_id               | String                                                                  | **参数解释** 模块ID **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| module_name             | String                                                                  | **参数解释** 模块名称 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| module_path             | String                                                                  | **参数解释** 模块path **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| module_path_name        | String                                                                  | **参数解释** 模块路径名称 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| execute_latest_time     | String                                                                  | **参数解释** 最后执行时间 **取值范围** 格式为yyyy-MM-dd HH:mm:ss                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| execute_duration        | String                                                                  | **参数解释** 执行时长，单位（毫秒） **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| execute_times           | Integer                                                                 | **参数解释** 执行次数 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| is_keyword              | Integer                                                                 | **参数解释** 是否关键用例 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| release_dev             | String                                                                  | **参数解释** 测试版本号 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| new_created             | String                                                                  | **参数解释** 是否用户新增用例 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| project_uuid            | String                                                                  | **参数解释** 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围** 长度等于32位，包含大小写字母、数字                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| creation_version_name   | String                                                                  | **参数解释** 创建版本名称，原逻辑marshall添加字段 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| feature_path            | String                                                                  | **参数解释** 特性路径，原逻辑marshall添加字段 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| testcase_uri            | String                                                                  | **参数解释** 实体用例Uri，IteratorTestCase字段 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| owner_name              | String                                                                  | **参数解释** 处理人名称 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| iterator_case_uri       | String                                                                  | **参数解释** 迭代用例Uri，IteratorTestCase字段 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| script_link             | String                                                                  | **参数解释** 脚本链接scriptLink **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| test_step_model         | String                                                                  | **参数解释** 测试步骤模式 **取值范围** text: 文本模式; table: 表格模式                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| custom_field_1          | String                                                                  | **参数解释** 自定义字段1 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| custom_field_2          | String                                                                  | **参数解释** 自定义字段2 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| custom_field_3          | String                                                                  | **参数解释** 自定义字段3 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| custom_field_4          | String                                                                  | **参数解释** 自定义字段4 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| custom_field_5          | String                                                                  | **参数解释** 自定义字段5 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| custom_field_6          | String                                                                  | **参数解释** 自定义字段6 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| custom_field_7          | String                                                                  | **参数解释** 自定义字段7 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| custom_field_8          | String                                                                  | **参数解释** 自定义字段8 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| custom_field_9          | String                                                                  | **参数解释** 自定义字段9 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| custom_field_10         | String                                                                  | **参数解释** 自定义字段10 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_11         | String                                                                  | **参数解释** 自定义字段11 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_12         | String                                                                  | **参数解释** 自定义字段12 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_13         | String                                                                  | **参数解释** 自定义字段13 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_14         | String                                                                  | **参数解释** 自定义字段14 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_15         | String                                                                  | **参数解释** 自定义字段15 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_16         | String                                                                  | **参数解释** 自定义字段16 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_17         | String                                                                  | **参数解释** 自定义字段17 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_18         | String                                                                  | **参数解释** 自定义字段18 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_19         | String                                                                  | **参数解释** 自定义字段19 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_20         | String                                                                  | **参数解释** 自定义字段20 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_21         | String                                                                  | **参数解释** 自定义字段21 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_22         | String                                                                  | **参数解释** 自定义字段22 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_23         | String                                                                  | **参数解释** 自定义字段23 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_24         | String                                                                  | **参数解释** 自定义字段24 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| custom_field_25         | String                                                                  | **参数解释** 自定义字段25 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   
 表7NameAndId 
| 参数   | 参数类型   | 描述                                                                                                                                                                 |
|:---|:---|:---|
| id   | String | **参数解释**: 对象编号 **取值范围**: 11-34位的字母及数字（字符串） |
| name | String | **参数解释**: 对象名称 **取值范围**: 不涉及               |
   
**状态码：400**
表8响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                        |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：401**
表9响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                        |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：404**
表10响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                        |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：500**
表11响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                        |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
#### 请求示例
```
post https://{endpoint}/testrelation/v4/efdb403066474ab08836b9eeaaa23bca/issues/894789325632/testcases/batch-query
{
  "page_no" : 1,
  "page_size" : 10,
  "sort_field" : "name",
  "sort_type" : "DESC",
  "version_uri" : "858ds8ew2",
  "relate_type" : "bug/requirement",
  "key_word" : "keyWord",
  "rank_ids" : [ "1", "2" ],
  "result_codes" : [ "0", "1" ]
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "value" : {
    "case_status_map" : {
      "新建" : 1,
      "完成" : 1
    },
    "new_create" : 1,
    "designing" : 0,
    "finished" : 1,
    "testing" : 0,
    "test_case_num" : 2,
    "testcases" : [ {
      "uri" : "v90510sa530ad5pe",
      "type" : "TestCase",
      "author" : "昵称",
      "name" : "qqqqqqqqqqq",
      "rank" : 2,
      "preparation" : "1、确保网路联通\n2、安装Chrome浏览器\n3、准备测试账户，请从账户管理系统获取最新测试账号和密码",
      "remark" : "验证使用华为云账号登录华为云官网功能",
      "region" : "roma-guian-2",
      "version_uri" : "v90200010ovl7ss9",
      "parent_uri" : "v90200010ovl7ss9",
      "parent_path" : "/9c115c0e26ee492386cfa408f7e8ed92/v90200010ovl7ss9/",
      "creation_version_uri" : "v90200010ovl7svc",
      "last_modifier" : "昵称echotest_dl",
      "last_modified" : "2025-10-21 14:58:01",
      "last_change_time" : "2025-10-21 14:58:01",
      "creation_date" : "2025-10-20 17:54:44",
      "author_id" : "c217c42b8dfb4ac7bff52a87cbaca38c",
      "number" : "v92s00010hovp2cp",
      "case_type" : 0,
      "platform_type" : 0,
      "service_type" : 100,
      "test_type" : 1,
      "test_step" : "[\"在浏览器地址栏输入“{url}”，按“回车”键\",\"输入测试账号\",\"输入测试账号密码\",\"点击“登录”按钮\"]",
      "expect_output" : "[\"浏览器跳转到华为云登录页面，登录框中展示“华为账号登录”\",\"账号输入框内显示输入的账号\",\"密码输入框内显示与输入密码位数一致的“*”符号\",\"登录成功，跳转到华为云首页，并在网页右上角以红色字体显示用户昵称\"]",
      "auto_type" : 0,
      "to_be_auto_exec" : 0,
      "feature_uri" : "v90500010sa52tfv",
      "automatically_executed" : 0,
      "is_contract_testcase" : 0,
      "time_cost" : 0,
      "status_code" : "0",
      "is_keyword" : 0,
      "project_uuid" : "9c115c0e26ee492386cfa408f7e8ed92",
      "issue_id" : "[\"1186322840050868225\"]",
      "issue_tracker_id" : "[\"7\"]",
      "issue_assign_status" : "[null]",
      "issue_name" : "[\"1\"]",
      "issue_design_owner" : "[null]",
      "issue_design_owner_d" : "[null]",
      "tracker_name" : "[\"IR\"]",
      "defect_list" : [ ],
      "status_name" : "新建"
    }, {
      "uri" : "v90100010q4flsj1",
      "type" : "TestCase",
      "author" : "昵称",
      "name" : "1113",
      "rank" : 2,
      "preparation" : "",
      "remark" : "2222",
      "stage" : "1",
      "designer" : "c217c42b8dfb4ac7bff52a87cbaca38c",
      "region" : "roma-guian-2",
      "owner" : "",
      "version_uri" : "v90200010ovl7ss9",
      "parent_uri" : "v90200010ovl7ss9",
      "parent_path" : "/9c115c0e26ee492386cfa408f7e8ed92/v90200010ovl7ss9/",
      "last_modifier" : "昵称echotest_dl",
      "last_modified" : "2025-09-30 11:14:49",
      "last_change_time" : "2025-09-30 11:14:49",
      "creation_date" : "2025-09-23 16:32:58",
      "author_id" : "c217c42b8dfb4ac7bff52a87cbaca38c",
      "number" : "109",
      "case_type" : 0,
      "platform_type" : 0,
      "service_type" : 100,
      "test_type" : 1,
      "test_step" : "[\"\"]",
      "expect_output" : "[\"\"]",
      "svn_script_path" : "./test/test3.py",
      "auto_type" : 0,
      "to_be_auto_exec" : 0,
      "feature_uri" : "",
      "dr_relation_id" : "",
      "automatically_executed" : 0,
      "is_contract_testcase" : 0,
      "time_cost" : 0,
      "last_exe_author" : "c217c42b8dfb4ac7bff52a87cbaca38c",
      "status_code" : "7",
      "result_code" : "0",
      "release_id" : "",
      "label_id" : "",
      "module_id" : "",
      "execute_latest_time" : "2025-09-23 16:36:44",
      "execute_duration" : "00:00:00.000",
      "is_keyword" : 0,
      "release_dev" : "",
      "project_uuid" : "9c115c0e26ee492386cfa408f7e8ed92",
      "issue_id" : "[\"1186322840050868225\"]",
      "issue_tracker_id" : "[\"7\"]",
      "issue_assign_status" : "[null]",
      "issue_name" : "[\"1\"]",
      "issue_design_owner" : "[null]",
      "issue_design_owner_d" : "[null]",
      "tracker_name" : "[\"IR\"]",
      "defect_list" : [ ],
      "result_name" : "成功",
      "status_name" : "完成"
    } ],
    "total_count" : 2
  }
}
```
#### SDK代码示例
SDK代码示例如下。
#### Java
```
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 ListTestCasesByIssueSolution {
    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();
        ListTestCasesByIssueRequest request = new ListTestCasesByIssueRequest();
        request.withIssueId("{issue_id}");
        request.withProjectId("{project_id}");
        QueryTestCasesByIssueInfo body = new QueryTestCasesByIssueInfo();
        List<String> listbodyResultCodes = new ArrayList<>();
        listbodyResultCodes.add("0");
        listbodyResultCodes.add("1");
        List<String> listbodyRankIds = new ArrayList<>();
        listbodyRankIds.add("1");
        listbodyRankIds.add("2");
        body.withResultCodes(listbodyResultCodes);
        body.withRankIds(listbodyRankIds);
        body.withKeyWord("keyWord");
        body.withRelateType("bug/requirement");
        body.withVersionUri("858ds8ew2");
        body.withSortType("DESC");
        body.withSortField("name");
        body.withPageSize(10);
        body.withPageNo(1);
        request.withBody(body);
        try {
            ListTestCasesByIssueResponse response = client.listTestCasesByIssue(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
```
# 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 = ListTestCasesByIssueRequest()
        request.issue_id = "{issue_id}"
        request.project_id = "{project_id}"
        listResultCodesbody = [
            "0",
            "1"
        ]
        listRankIdsbody = [
            "1",
            "2"
        ]
        request.body = QueryTestCasesByIssueInfo(
            result_codes=listResultCodesbody,
            rank_ids=listRankIdsbody,
            key_word="keyWord",
            relate_type="bug/requirement",
            version_uri="858ds8ew2",
            sort_type="DESC",
            sort_field="name",
            page_size=10,
            page_no=1
        )
        response = client.list_test_cases_by_issue(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
```
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.ListTestCasesByIssueRequest{}
request.IssueId = "{issue_id}"
request.ProjectId = "{project_id}"
var listResultCodesbody = []string{
        "0",
    "1",
    }
var listRankIdsbody = []string{
        "1",
    "2",
    }
keyWordQueryTestCasesByIssueInfo:= "keyWord"
relateTypeQueryTestCasesByIssueInfo:= "bug/requirement"
versionUriQueryTestCasesByIssueInfo:= "858ds8ew2"
sortTypeQueryTestCasesByIssueInfo:= "DESC"
sortFieldQueryTestCasesByIssueInfo:= "name"
pageSizeQueryTestCasesByIssueInfo:= int32(10)
pageNoQueryTestCasesByIssueInfo:= int32(1)
request.Body = &model.QueryTestCasesByIssueInfo{
ResultCodes: &listResultCodesbody,
RankIds: &listRankIdsbody,
KeyWord: &keyWordQueryTestCasesByIssueInfo,
RelateType: &relateTypeQueryTestCasesByIssueInfo,
VersionUri: &versionUriQueryTestCasesByIssueInfo,
SortType: &sortTypeQueryTestCasesByIssueInfo,
SortField: &sortFieldQueryTestCasesByIssueInfo,
PageSize: &pageSizeQueryTestCasesByIssueInfo,
PageNo: &pageNoQueryTestCasesByIssueInfo,
}
response, err := client.ListTestCasesByIssue(request)
if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}
```
#### 更多
更多编程语言的SDK代码示例，请参见[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CloudTest/sdk?api=ListTestCasesByIssue)的代码示例页签，可生成自动对应的SDK代码示例。
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。
