
# 查询用例列表 - ListTestCaseUris
#### 功能介绍
此接口用于查询用例列表，同页面 测试 -\> 测试用例 -\> 右侧展示用例列表
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /v4/{project_id}/testcases/batch-list
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释** 项目UUID **约束限制** 字符串类型，固定为32位字母和数字 **取值范围** 项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **默认取值** 不涉及\](cloudtest_03_4003.xml) |
   
#### 请求参数
表2请求Body参数 
| 参数                     | 是否必选 | 参数类型                                                                                       | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| keyword                | 否    | String                                                                                     | **参数解释** 关键字查询，用例名或编号 **约束限制** 字符串类型 **取值范围** 字符串类型，小于128位的字符串 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| exeplatforms           | 否    | Array of strings                                                                           | **参数解释** 执行平台集合 **约束限制** 字符串类型 **取值范围** 小于128位的字符串 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| own                    | 否    | Boolean                                                                                    | **参数解释** 是否是我的 **约束限制** 不涉及 **取值范围** - true，是。   - false，否。    **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| useOffset              | 否    | Boolean                                                                                    | **参数解释** 是否使用offset分页 **约束限制** 不涉及 **取值范围** - true，是。   - false，否。    **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| queryByDisplayCfg      | 否    | Boolean                                                                                    | **参数解释** 是否表头配置查询 **约束限制** 如果为true,则未设置展示的字段不返回 **取值范围** - true，是。   - false，否。    **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| version_uri            | 否    | String                                                                                     | **参数解释** 版本URI **约束限制** 字符串类型 **取值范围** 字符串类型，11-34位字母和数字 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| case_uris              | 否    | Array of strings                                                                           | **参数解释** 用例URI集合 **约束限制** 不涉及 **取值范围** 字符串类型 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| owner_ids              | 否    | Array of strings                                                                           | **参数解释** 处理者ID集合 **约束限制** 不涉及 **取值范围** 字符串类型 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| status_codes           | 否    | Array of strings                                                                           | **参数解释** 状态Code集合 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| rank_ids               | 否    | Array of strings                                                                           | **参数解释** 用例等级ID集合 **约束限制** 不涉及 **取值范围** 可传0,1,2,3,4 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| module_ids             | 否    | Array of strings                                                                           | **参数解释** 模块ID集合 **约束限制** 字符串类型 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| issue_id               | 否    | String                                                                                     | **参数解释** 需求编号 **约束限制** 字符串类型 **取值范围** 1-32位数字 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| creator_ids            | 否    | Array of strings                                                                           | **参数解释** 创建者ID集合 **约束限制** 集合中数据为字符串类型 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| result_codes           | 否    | Array of strings                                                                           | **参数解释** 结果Code集合 **约束限制** 不涉及 **取值范围** 可传1-5位的数字 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| iteration_ids          | 否    | Array of strings                                                                           | **参数解释** 归属迭代ID集合 **约束限制** 不涉及 **取值范围** 字符串类型 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| create_start_time      | 否    | String                                                                                     | **参数解释** 创建开始时间 **约束限制** 字符串类型 **取值范围** 时间格式为"yyyy-MM-dd HH:mm:ss" **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| create_end_time        | 否    | String                                                                                     | **参数解释** 创建结束时间 **约束限制** 字符串类型 **取值范围** 时间格式为"yyyy-MM-dd HH:mm:ss" **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| associated_issue       | 否    | Boolean                                                                                    | **参数解释** 是否关联需求 **约束限制** 不涉及 **取值范围** - true，已关联。   - false，未关联。   - null，不限。    **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| associated_defects     | 否    | Boolean                                                                                    | **参数解释** 是否关联缺陷 **约束限制** 不涉及 **取值范围** - true，已关联。   - false，未关联。   - null，不限。    **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| include_sub_issue      | 否    | Boolean                                                                                    | **参数解释** 是否查询子需求关联的用例 **约束限制** 不涉及 **取值范围** - true，是。   - false，否。    **默认取值** true                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| include_sub_feature    | 否    | Boolean                                                                                    | **参数解释** 是否查询子目录的用例 **约束限制** 不涉及 **取值范围** - true，是。   - false，否。    **默认取值** true                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| label_ids              | 否    | Array of strings                                                                           | **参数解释** 标签ID集合 **约束限制** 集合里元素为字符串类型 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| execute_start_time     | 否    | String                                                                                     | **参数解释** 执行开始时间 **约束限制** 字符串类型 **取值范围** 时间格式为"yyyy-MM-dd HH:mm:ss" **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| execute_end_time       | 否    | String                                                                                     | **参数解释** 执行结束时间 **约束限制** 字符串类型 **取值范围** 时间格式为"yyyy-MM-dd HH:mm:ss" **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| executor_ids           | 否    | Array of strings                                                                           | **参数解释** 执行者ID集合 **约束限制** 集合中元素为字符串类型 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| test_types             | 否    | Array of strings                                                                           | **参数解释** 测试类型 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| is_keyword             | 否    | Boolean                                                                                    | **参数解释** 是否组合关键字 **约束限制** 不涉及 **取值范围** - true，是。   - false，否。    **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| issue_tree_search      | 否    | Boolean                                                                                    | **参数解释** 是否是需求树点击的查询关联用例 **约束限制** 不涉及 **取值范围** - true，是。   - false，否。    **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| service_type           | 否    | Integer                                                                                    | **参数解释**: 服务类型 **约束限制**: 不涉及 **取值范围**: - -1，全量用例。   - 0，手工测试。   - 1，接口自动化。   - 7，功能自动化。   - 8，WebUI自动化。   - 100，自定义自动化(工厂)。   - 11，性能自动化。    **默认取值**: 不涉及 |
| service_types          | 否    | Array of integers                                                                          | **参数解释** 服务类型集合 **约束限制** 数组中元素为整数类型 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| stage_type             | 否    | Integer                                                                                    | **参数解释** 阶段过程 **约束限制** 不涉及 **取值范围** - 2，测试设计。   - 3，测试执行。   - 4，质量报告。    **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| feature_uri            | 否    | String                                                                                     | **参数解释** 目录URI **约束限制** 字符串类型 **取值范围** 11-34位字母和数字 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| name                   | 否    | String                                                                                     | **参数解释** 用例名称 **约束限制** 字符串类型 **取值范围** 小于128位的字符串 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| number                 | 否    | String                                                                                     | **参数解释** 用例编号 **约束限制** 仅支持模糊搜索用例名称 **取值范围** 字符串类型，11-34位字母和数字 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| number_exact_search    | 否    | String                                                                                     | **参数解释** 用例编号 **约束限制** 仅支持分支内精确搜索，不支持迭代搜索 **取值范围** 字符串类型，11-34位字母和数字 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| remark                 | 否    | String                                                                                     | **参数解释** 用例描述 **约束限制** 字符串类型 **取值范围** 小于256位的字符串 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| sort_field             | 否    | String                                                                                     | **参数解释** 排序字段 **约束限制** 字符串类型 **取值范围** 小于128位的字符串 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| sort_type              | 否    | String                                                                                     | **参数解释**: 排序方式 **约束限制**: 字符串类型 **取值范围**: - ASC，升序。   - DESC，降序。    **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| page_no                | 是    | Integer                                                                                    | **参数解释** 当前页数 **约束限制** 整数 **取值范围** 大于1，小于100的整数 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| page_size              | 是    | Integer                                                                                    | **参数解释** 每页条数 **约束限制** 整数 **取值范围** 大于1，小于50的整数 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| case_type              | 否    | Integer                                                                                    | **参数解释**: 用例类型 **约束限制**: 整数类型 **取值范围**: - 0，手工测试。   - 1，接口自动化。   - 2，性能用例。    **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| custom_field_info      | 否    | Array of [QueryCustomFieldsInfo] objects | **参数解释** 用例自定义字段信息 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| task_uri               | 否    | String                                                                                     | **参数解释** 测试套uri **约束限制** 字符串类型 **取值范围** 字符串类型，长度为11-34位的字母或数字 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| associate_issue_detail | 否    | Boolean                                                                                    | **参数解释** 是否返回需求具体信息（返回需求名称，需求id） **约束限制** 不涉及 **取值范围** - true，是。   - false，否。    **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| not_assign_task        | 否    | Boolean                                                                                    | **参数解释** 是否查询未分配测试套的用例 **约束限制** 不涉及 **取值范围** - true，查询未分配测试套的用例。   - false，则查询全量用例。    **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| test_designs           | 否    | Array of booleans                                                                          | **参数解释** 测试设计信息集合 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| review_status          | 否    | Integer                                                                                    | **参数解释**: 用例评审状态 **取值范围**: - 0，未评审。   - 1，已评审。    **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| just_return_id         | 否    | Boolean                                                                                    | **参数解释** 部分字段是否仅返回ID **约束限制** 不涉及 **取值范围** - true，是。   - false，否。    **默认取值** false                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   
 表3QueryCustomFieldsInfo 
| 参数         | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| id         | 否    | Integer          | **参数解释**: 测试用例自定义字段Id **约束限制**: 不涉及 **取值范围**: 不涉及 **默认取值**: 不涉及         |
| values     | 否    | Array of strings | **参数解释**: 测试用例自定义字段值 **约束限制**: 不涉及 **取值范围**: 不涉及 **默认取值**: 不涉及          |
| field_name | 否    | String           | **参数解释**: 自定义字段名 **约束限制**: 不涉及 **取值范围**: 优先取id再取fieldName **默认取值**: 不涉及 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数        | 参数类型                                                                          | 描述                                                                                                                                                 |
|:---|:---|:---|
| total     | Integer                                                                       | **参数解释** 总数 **取值范围** 不小于1的正整数          |
| page_no   | Integer                                                                       | **参数解释** 分页编码 **取值范围** 大于0且小于100的正整数   |
| page_size | Integer                                                                       | **参数解释** 分页大小 **取值范围** 大于零且小于20000的正整数 |
| value     | Array of [TestCaseListVo] objects | 请求返回的数据                                                                                                                                            |
   
 表5TestCaseListVo 
| 参数                    | 参数类型                                                                              | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| uri                   | String                                                                            | **参数解释**: 用例URI **取值范围**: 字符串类型，长度11-34位字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| name                  | String                                                                            | **参数解释**: 用例名称 **取值范围**: 字符串类型，小于128位字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| owner                 | [NameAndIdVo] object                     | **参数解释**: 处理者 **取值范围**: 字符串类型，小于128位字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| status                | [NameAndIdVo] object                     | **参数解释**: 状态 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| result                | [NameAndIdVo] object                     | **参数解释**: 结果 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| module                | [NameAndIdVo] object                     | **参数解释**: 模块 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| iteration             | [NameAndIdVo] object                     | **参数解释**: 迭代 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| exeplatform           | String                                                                            | **参数解释**: 执行平台 **取值范围**: apittest,其他三方执行平台                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| number                | String                                                                            | **参数解释**: 用例编号 **取值范围**: 字符串类型，小于128位字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| description           | String                                                                            | **参数解释**: 用例描述 **取值范围**: 字符串类型，小于256位字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| rank_id               | String                                                                            | **参数解释**: 用例等级 **取值范围**: - 0，Priority 0。   - 1，Priority 1。   - 2，Priority 2。   - 3，Priority 3。   - 4，Priority 4。    |
| feature_uri           | String                                                                            | **参数解释**: 目录URI **取值范围**: 字符串类型，11-34位字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| release_dev           | String                                                                            | **参数解释**: 版本号 **取值范围**: 3-32位字符，允许：汉字、字母（a-z, A-Z）、数字（0-9）、下划线（_）、连字符（-）、点号（.）、破折号（---）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| is_keyword            | Boolean                                                                           | **参数解释**: 是否组合关键字 **取值范围**: - true: 组合关键字   - false:不组合关键字                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| script_url            | String                                                                            | **参数解释**: 脚本路径 **取值范围**: 字符串类型，如"/script/test.py"路径                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| report_url            | String                                                                            | **参数解释**: 实时报告地址 **取值范围**: 字符串类型，返回一个url                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| project_uuid          | String                                                                            | **参数解释**: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围**: 字符串类型，长度等于32位，包含大小写字母、数字                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| service_type          | [NameAndIdVo] object                     | **参数解释**: 服务类型信息 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| test_type             | [IntegerIdAndNameVo] object       | **参数解释**: 测试类型信息 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| create_info           | [CreateInfoVo] object                   | **参数解释**: 创建信息 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| execute_info          | [ExecuteInfoVo] object                 | **参数解释**: 执行信息 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| associate_issue_info  | [AssociateIssueInfoVo] object   | **参数解释**: 关联需求信息 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| associate_defect_info | [AssociateDefectInfoVo] object | **参数解释**: 关联缺陷信息 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| case_type             | Integer                                                                           | **参数解释**: 用例类型 **取值范围**: - 0，手工测试。   - 1，接口自动化。   - 2，性能用例。                                                                                                                                                                                                                                                                                                                     |
| labels                | String                                                                            | **参数解释**: 用例标签名称列表 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| custom_field_info     | Array of [CustomFieldVo] objects       | **参数解释**: 自定义字段信息 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| is_test_design        | Boolean                                                                           | **参数解释**: 是否来自测试设计 **取值范围**: - null：不限   - false：否来自测试设计    -true：来自测试设计                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| last_modified         | Long                                                                              | **参数解释**: 最后修改时间 **取值范围**: 时间戳，单位：毫秒                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| review_status         | Integer                                                                           | 用例评审状态 **取值范围**: - 0，未评审。   - 1，已评审。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| case_create_date      | Long                                                                              | 用例创建时间（null：不限）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| confidentiality_code  | String                                                                            | **参数解释** 资源密级等级编码，只有在涉密开关打开时，且资源设置了密级等级，才会返回 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   
 表6NameAndIdVo 
| 参数   | 参数类型   | 描述                                                                                                                                   |
|:---|:---|:---|
| id   | String | **参数解释** ID **取值范围** 不涉及 |
| name | String | **参数解释** 名称 **取值范围** 不涉及 |
   
 表7IntegerIdAndNameVo 
| 参数   | 参数类型    | 描述                                                                                                                                        |
|:---|:---|:---|
| id   | Integer | **参数解释** 数据库存储数字 **取值范围** 不涉及 |
| name | String  | **参数解释** 页面显示值 **取值范围** 不涉及   |
   
 表8CreateInfoVo 
| 参数        | 参数类型   | 描述                                                                                                                                          |
|:---|:---|:---|
| time      | String | **参数解释**: 创建时间 **取值范围**: 不涉及    |
| timestamp | Long   | **参数解释**: 创建时间时间戳 **取值范围**: 不涉及 |
| user_id   | String | **参数解释**: 用户ID **取值范围**: 不涉及    |
| user_name | String | **参数解释**: 用户名称 **取值范围**: 不涉及    |
   
 表9ExecuteInfoVo 
| 参数            | 参数类型    | 描述                                                                                                                                            |
|:---|:---|:---|
| time          | String  | **参数解释**: 执行开始时间 **取值范围**: 不涉及    |
| timestamp     | Long    | **参数解释**: 执行开始时间时间戳 **取值范围**: 不涉及 |
| duration      | String  | **参数解释**: 执行时长 **取值范围**: 不涉及      |
| user_id       | String  | **参数解释**: 用户ID **取值范围**: 不涉及      |
| user_name     | String  | **参数解释**: 用户名称 **取值范围**: 不涉及      |
| execute_times | Integer | **参数解释**: 执行次数 **取值范围**: 不涉及      |
   
 表10AssociateIssueInfoVo 
| 参数           | 参数类型    | 描述                                                                                                                                                        |
|:---|:---|:---|
| associate    | Boolean | **参数解释**: 是否已关联 **取值范围**: true: 已关联 false:未关联 |
| issue_id     | String  | **参数解释**: 需求ID **取值范围**: 不涉及                  |
| tracker_id   | String  | **参数解释**: 需求类型 **取值范围**: 不涉及                  |
| board_id     | String  | **参数解释**: 工作项层级ID **取值范围**: 不涉及               |
| tracker_name | String  | **参数解释**: 需求类型名称 **取值范围**: 不涉及                |
   
 表11AssociateDefectInfoVo 
| 参数              | 参数类型    | 描述                                                                                                                                                       |
|:---|:---|:---|
| associate       | Boolean | **参数解释**: 是否已关联 **取值范围**: true:已关联 false:未关联 |
| associate_count | Integer | **参数解释**: 关联缺陷数 **取值范围**: 不涉及                |
   
 表12CustomFieldVo 
| 参数                 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|
| type               | String | **参数解释**: 字段类型 **取值范围**: - 单行文本text   - 多行文本textArea   - 单选框radio   - 多选框checkBox   - 日期date   - 数字number   - 单选用户user    |
| value              | String | **参数解释**: 测试用例自定义字段值 **取值范围**: 字符串类型                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| custom_field_param | String | **参数解释**: 项目用例自定义字段入参或者返回参数名称 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| user_name          | String | **参数解释**: 用户名 **取值范围**: user类型测试用例自定义字段对应用户名，其它类型字段不返回                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   
**状态码：400**
表13响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                             |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：401**
表14响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                             |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：404**
表15响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                             |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：500**
表16响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                             |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
#### 请求示例
```
{
  "page_no" : 1,
  "page_size" : 15,
  "feature_uri" : "42f27e960b6a41b89c093cbdc657a07d",
  "service_type" : -1,
  "stage_type" : "3",
  "custom_field_info" : [ ],
  "version_uri" : "v9020001099p8qk4",
  "just_return_id" : true
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "total" : 159,
  "value" : [ {
    "uri" : "v90200010scjm23o",
    "name" : "hahaha139c",
    "owner" : { },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "TC1326",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "1b7179edc79a431f9711434124ac9f28",
    "service_type" : {
      "id" : "1",
      "name" : "接口自动化"
    },
    "test_type" : {
      "id" : 0
    },
    "create_info" : {
      "time" : "2025-10-21 16:48:18",
      "timestamp" : 1761036498000,
      "user_id" : "da48b09775884920a3745ccbd4a66f1e",
      "user_name" : "wldC0001"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "custom_field_info" : [ {
      "type" : "text",
      "value" : "222",
      "custom_field_param" : "custom_field_23"
    } ],
    "is_test_design" : false,
    "last_modified" : 1761036498000,
    "review_status" : 0
  }, {
    "uri" : "v90100010scj7pkq",
    "name" : "hahaha19c",
    "owner" : { },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "TC1325",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "1b7179edc79a431f9711434124ac9f28",
    "service_type" : {
      "id" : "1",
      "name" : "接口自动化"
    },
    "test_type" : {
      "id" : 0
    },
    "create_info" : {
      "time" : "2025-10-21 16:40:30",
      "timestamp" : 1761036030000,
      "user_id" : "da48b09775884920a3745ccbd4a66f1e",
      "user_name" : "wldC0001"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "custom_field_info" : [ {
      "type" : "text",
      "value" : "222",
      "custom_field_param" : "custom_field_23"
    } ],
    "is_test_design" : false,
    "last_modified" : 1761036030000,
    "review_status" : 0
  }, {
    "uri" : "v90200010scj6vf1",
    "name" : "hahaha1c",
    "owner" : { },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "TC1324",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "1b7179edc79a431f9711434124ac9f28",
    "service_type" : {
      "id" : "1",
      "name" : "接口自动化"
    },
    "test_type" : {
      "id" : 0
    },
    "create_info" : {
      "time" : "2025-10-21 16:40:03",
      "timestamp" : 1761036003000,
      "user_id" : "da48b09775884920a3745ccbd4a66f1e",
      "user_name" : "wldC0001"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "custom_field_info" : [ {
      "type" : "text",
      "value" : "222",
      "custom_field_param" : "custom_field_23"
    } ],
    "is_test_design" : false,
    "last_modified" : 1761036003000,
    "review_status" : 0
  }, {
    "uri" : "v90100010scj618m",
    "name" : "3wer432",
    "owner" : {
      "id" : ""
    },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "TC1323",
    "rank_id" : "2",
    "is_keyword" : false,
    "script_url" : "ApiTest/wldIPD-系统设备类1017_alpha/src/scripts/user/Case_c1dc177717374d2684540b81b979a710_1.java",
    "report_url" : "",
    "project_uuid" : "1b7179edc79a431f9711434124ac9f28",
    "service_type" : {
      "id" : "1",
      "name" : "接口自动化"
    },
    "test_type" : {
      "id" : 1,
      "name" : "功能性测试"
    },
    "create_info" : {
      "time" : "2025-10-21 16:39:32",
      "timestamp" : 1761035972000,
      "user_id" : "da48b09775884920a3745ccbd4a66f1e",
      "user_name" : "wldC0001"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "custom_field_info" : [ {
      "type" : "text",
      "value" : "33",
      "custom_field_param" : "custom_field_20"
    }, {
      "type" : "text",
      "value" : "222",
      "custom_field_param" : "custom_field_23"
    } ],
    "is_test_design" : false,
    "last_modified" : 1761035972000,
    "review_status" : 0
  }, {
    "uri" : "v90100010scfv57e",
    "name" : "aaa",
    "owner" : {
      "id" : ""
    },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "TC1321",
    "rank_id" : "2",
    "is_keyword" : false,
    "script_url" : "ApiTest/wldIPD-系统设备类1017_alpha/src/scripts/user/Case_903485a6fa27452399909273dfc89a36_1.java",
    "report_url" : "",
    "project_uuid" : "1b7179edc79a431f9711434124ac9f28",
    "service_type" : {
      "id" : "1",
      "name" : "接口自动化"
    },
    "test_type" : {
      "id" : 21,
      "name" : "可服务性测试"
    },
    "create_info" : {
      "time" : "2025-10-21 15:43:21",
      "timestamp" : 1761032601000,
      "user_id" : "da48b09775884920a3745ccbd4a66f1e",
      "user_name" : "wldC0001"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "custom_field_info" : [ {
      "type" : "text",
      "value" : "33",
      "custom_field_param" : "custom_field_20"
    }, {
      "type" : "text",
      "value" : "222",
      "custom_field_param" : "custom_field_23"
    } ],
    "is_test_design" : false,
    "last_modified" : 1761032601000,
    "review_status" : 0
  }, {
    "uri" : "v90200010sbu3pfq",
    "name" : "作为管理员进行订单管理",
    "owner" : { },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "005",
    "rank_id" : "2",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "1b7179edc79a431f9711434124ac9f28",
    "service_type" : {
      "id" : "0",
      "name" : "手工测试"
    },
    "test_type" : {
      "id" : 1,
      "name" : "功能性测试"
    },
    "create_info" : {
      "time" : "2025-10-21 10:31:19",
      "timestamp" : 1761013879000,
      "user_id" : "a17801c5d15f46e28112eec8a880683d",
      "user_name" : "wangluodan1"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "is_test_design" : false,
    "last_modified" : 1761013879000,
    "review_status" : 0
  }, {
    "uri" : "v90200010sbu3peh",
    "name" : "作为管理员进行积分管理",
    "owner" : { },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "004",
    "rank_id" : "2",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "1b7179edc79a431f9711434124ac9f28",
    "service_type" : {
      "id" : "0",
      "name" : "手工测试"
    },
    "test_type" : {
      "id" : 1,
      "name" : "功能性测试"
    },
    "create_info" : {
      "time" : "2025-10-21 10:31:19",
      "timestamp" : 1761013879000,
      "user_id" : "a17801c5d15f46e28112eec8a880683d",
      "user_name" : "wangluodan1"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "is_test_design" : false,
    "last_modified" : 1761013879000,
    "review_status" : 0
  }, {
    "uri" : "v90200010sbu3pd8",
    "name" : "作为管理员添加优惠活动",
    "owner" : { },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "003",
    "rank_id" : "2",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "1b7179edc79a431f9711434124ac9f28",
    "service_type" : {
      "id" : "0",
      "name" : "手工测试"
    },
    "test_type" : {
      "id" : 1,
      "name" : "功能性测试"
    },
    "create_info" : {
      "time" : "2025-10-21 10:31:19",
      "timestamp" : 1761013879000,
      "user_id" : "a17801c5d15f46e28112eec8a880683d",
      "user_name" : "wangluodan1"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "is_test_design" : false,
    "last_modified" : 1761013879000,
    "review_status" : 0
  }, {
    "uri" : "v90200010sbu3pbf",
    "name" : "作为管理员添加团购活动",
    "owner" : { },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "002",
    "rank_id" : "2",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "1b7179edc79a431f9711434124ac9f28",
    "service_type" : {
      "id" : "0",
      "name" : "手工测试"
    },
    "test_type" : {
      "id" : 1,
      "name" : "功能性测试"
    },
    "create_info" : {
      "time" : "2025-10-21 10:31:19",
      "timestamp" : 1761013879000,
      "user_id" : "a17801c5d15f46e28112eec8a880683d",
      "user_name" : "wangluodan1"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "is_test_design" : false,
    "last_modified" : 1761013879000,
    "review_status" : 0
  }, {
    "uri" : "v90200010sbu3p81",
    "name" : "作为管理员添加限时打折",
    "owner" : { },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "001",
    "rank_id" : "2",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "1b7179edc79a431f9711434124ac9f28",
    "service_type" : {
      "id" : "0",
      "name" : "手工测试"
    },
    "test_type" : {
      "id" : 1,
      "name" : "功能性测试"
    },
    "create_info" : {
      "time" : "2025-10-21 10:31:19",
      "timestamp" : 1761013879000,
      "user_id" : "a17801c5d15f46e28112eec8a880683d",
      "user_name" : "wangluodan1"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "is_test_design" : false,
    "last_modified" : 1761013879000,
    "review_status" : 0
  } ],
  "page_size" : 10,
  "page_no" : 1
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。
