
# 查询用例列表 - ListAllTestCasesv4
#### 功能介绍
此接口用于查询用例列表，同页面 测试 -\> 测试用例 -\> 右侧展示页面，展示用例列表
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /v4/{project_id}/testcases/batch-query
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **约束限制**: 字符串类型，长度32位字符 **取值范围**: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字 **默认取值**: 不涉及 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 必传。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 |
   
表3请求Body参数 
| 参数                     | 是否必选 | 参数类型                                                                                         | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| keyword                | 否    | String                                                                                       | **参数解释**: 关键字查询 **约束限制**: 字符串类型 **取值范围**: 用例名或编号，字符串类型，长度128位以内 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| exeplatforms           | 否    | Array of strings                                                                             | **参数解释**: 执行平台列表数组 **约束限制**: 不涉及 **取值范围**: 不涉及 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| own                    | 否    | Boolean                                                                                      | **参数解释**: 是否是我的 **约束限制**: 不涉及 **取值范围**: - true:是   - false:不是    **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| useOffset              | 否    | Boolean                                                                                      | **参数解释**: 是否使用偏移量方式查询 **约束限制**: 不涉及 **取值范围**: - true:使用偏移量方式查询   - false:不使用偏移量方式查询    **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| version_uri            | 否    | String                                                                                       | **参数解释**: 版本URI **约束限制**: 11-34位字符 **取值范围**: 字符串类型，11到34位字母或数字 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| case_uris              | 否    | Array of strings                                                                             | **参数解释**: 用例URI集合 **约束限制**: 不涉及 **取值范围**: 字符串类型，长度为11-34位字母或数字 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| owner_ids              | 否    | Array of strings                                                                             | **参数解释**: 处理者ID集合 **约束限制**: 不涉及 **取值范围**: 字符串类型，字符长度小于128位 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| status_codes           | 否    | Array of strings                                                                             | **参数解释**: 状态Code集合 **约束限制**: 不涉及 **取值范围**: 不涉及 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| rank_ids               | 否    | Array of strings                                                                             | **参数解释**: 用例等级ID集合 **约束限制**: 不涉及 **取值范围**: 字符串类型，值为0,1,2,3,4 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| module_ids             | 否    | Array of strings                                                                             | **参数解释**: 模块ID集合 **约束限制**: 不涉及 **取值范围**: 0,1,2,3,4 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| issue_id               | 否    | String                                                                                       | **参数解释**: 需求编号 **约束限制**: 不涉及 **取值范围**: 不涉及 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| creator_ids            | 否    | Array of strings                                                                             | **参数解释**: 创建者ID集合 **约束限制**: 不涉及 **取值范围**: 字符串类型，值为小于128位的字母或数字的集合 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| result_codes           | 否    | Array of strings                                                                             | **参数解释**: 结果Code集合 **约束限制**: 不涉及 **取值范围**: 不涉及 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| iteration_ids          | 否    | Array of strings                                                                             | **参数解释**: 归属迭代ID集合 **约束限制**: 不涉及 **取值范围**: 字符串类型，11-34位的字母或数字 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| create_start_time      | 否    | String                                                                                       | **参数解释**: 创建开始时间 **约束限制**: 时间格式为"yyyy-MM-dd HH:mm:ss" **取值范围**: 不涉及 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| create_end_time        | 否    | String                                                                                       | **参数解释**: 创建结束时间 **约束限制**: 时间格式为"yyyy-MM-dd HH:mm:ss" **取值范围**: 不涉及 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| associated_issue       | 否    | Boolean                                                                                      | **参数解释**: 是否关联需求 **约束限制**: 不涉及 **取值范围**: - null：不限   - true：已关联    -false：未关联 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| associated_defects     | 否    | Boolean                                                                                      | **参数解释**: 是否关联缺陷 **约束限制**: 不涉及 **取值范围**: - null：不限   - false：未关联    -true：已关联 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| include_sub_issue      | 否    | Boolean                                                                                      | **参数解释**: 是否查询子需求关联的用例 **约束限制**: 不涉及 **取值范围**: - true:查询子需求关联的用例    -false:不查询子需求关联的用例 **默认取值**: true                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| include_sub_feature    | 否    | Boolean                                                                                      | **参数解释**: 是否查询子目录的用例 **约束限制**: 不涉及 **取值范围**: - true:查询子目录关联的用例   - false:不查询子目录关联的用例    **默认取值**: true                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| label_ids              | 否    | Array of strings                                                                             | **参数解释**: 标签ID集合 **约束限制**: 不涉及 **取值范围**: 字符串类型，元素为长度不超过128位的字符串 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 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集合 **约束限制**: 字符串类型，数组中元素为长度不超过128位的字符串 **取值范围**: 不涉及 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 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                                                                            | **参数解释**: 服务类型集合 **约束限制**: 不涉及 **取值范围**: - -1，全量用例。   - 0，手工测试。   - 1，接口自动化。   - 7，功能自动化。   - 8，WebUI自动化。   - 100，自定义自动化(工厂)。   - 11，性能自动化。    **默认取值**: 不涉及 |
| stage_type             | 否    | Integer                                                                                      | **参数解释**: 阶段过程 **约束限制**: 正整数 **取值范围**: - 2：测试设计   - 3：测试执行，   - 4：质量报告    **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| feature_uri            | 否    | String                                                                                       | **参数解释**: 目录URI **约束限制**: 字符串类型 **取值范围**: 字符串类型，长度为11-34位的字母或数字 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| sort_field             | 否    | String                                                                                       | **参数解释**: 排序字段 **约束限制**: 不涉及 **取值范围**: name\|testCaseNumber\|status\|result\|createTime\|executeTime\|executeDuration\|module\|iteration **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| sort_type              | 否    | String                                                                                       | **参数解释**: 排序方式 **约束限制**: 不涉及 **取值范围**: - ASC，升序。   - DESC，降序。    **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| page_no                | 是    | Integer                                                                                      | **参数解释**: 当前页数 **约束限制**: 大于零的整数 **取值范围**: 1-20000 单位：条 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| page_size              | 是    | Integer                                                                                      | **参数解释**: 每页条数 **约束限制**: 大于零的整数 **取值范围**: 1-100 单位：条 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 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                                                                            | **参数解释**: 是否来自测试设计 **约束限制**: 不涉及 **取值范围**: - null或者\[true, false\]：不限    \[true\]：来自测试设计 \[false\]：否来自测试设计 **默认取值**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| review_status          | 否    | Integer                                                                                      | **参数解释**: 用例评审状态 **取值范围**: - 0，未评审。   - 1，已评审。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   
 表4QueryCustomFieldsInfo 
| 参数         | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| id         | 否    | Integer          | **参数解释**: 测试用例自定义字段Id **约束限制**: 不涉及 **取值范围**: 不涉及 **默认取值**: 不涉及         |
| values     | 否    | Array of strings | **参数解释**: 测试用例自定义字段值 **约束限制**: 不涉及 **取值范围**: 不涉及 **默认取值**: 不涉及          |
| field_name | 否    | String           | **参数解释**: 自定义字段名 **约束限制**: 不涉及 **取值范围**: 优先取id再取fieldName **默认取值**: 不涉及 |
   
#### 响应参数
**状态码：200**
表5响应Body参数 
| 参数        | 参数类型                                                                            | 描述                                                                                                                                                               |
|:---|:---|:---|
| total     | Integer                                                                         | **参数解释** 总数 **取值范围** 不小于1的正整数                  |
| page_no   | Integer                                                                         | **参数解释** 分页编码 **取值范围** 大于0且小于100的正整数           |
| page_size | Integer                                                                         | **参数解释** 分页大小 **取值范围** 大于零且小于20000的正整数         |
| value     | Array of [TestCaseListVo] objects | **参数解释**: 实际的数据类型：单个对象，集合 或 NULL **取值范围**: 不涉及 |
   
 表6TestCaseListVo 
| 参数                    | 参数类型                                                                                | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| 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                                                                              | **参数解释** 资源密级等级编码，只有在涉密开关打开时，且资源设置了密级等级，才会返回 **取值范围** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   
 表7NameAndIdVo 
| 参数   | 参数类型   | 描述                                                                                                                                         |
|:---|:---|:---|
| id   | String | **参数解释** ID **取值范围** 不涉及 |
| name | String | **参数解释** 名称 **取值范围** 不涉及 |
   
 表8IntegerIdAndNameVo 
| 参数   | 参数类型    | 描述                                                                                                                                              |
|:---|:---|:---|
| id   | Integer | **参数解释** 数据库存储数字 **取值范围** 不涉及 |
| name | String  | **参数解释** 页面显示值 **取值范围** 不涉及   |
   
 表9CreateInfoVo 
| 参数        | 参数类型   | 描述                                                                                                                                                |
|:---|:---|:---|
| time      | String | **参数解释**: 创建时间 **取值范围**: 不涉及    |
| timestamp | Long   | **参数解释**: 创建时间时间戳 **取值范围**: 不涉及 |
| user_id   | String | **参数解释**: 用户ID **取值范围**: 不涉及    |
| user_name | String | **参数解释**: 用户名称 **取值范围**: 不涉及    |
   
 表10ExecuteInfoVo 
| 参数            | 参数类型    | 描述                                                                                                                                                  |
|:---|:---|:---|
| time          | String  | **参数解释**: 执行开始时间 **取值范围**: 不涉及    |
| timestamp     | Long    | **参数解释**: 执行开始时间时间戳 **取值范围**: 不涉及 |
| duration      | String  | **参数解释**: 执行时长 **取值范围**: 不涉及      |
| user_id       | String  | **参数解释**: 用户ID **取值范围**: 不涉及      |
| user_name     | String  | **参数解释**: 用户名称 **取值范围**: 不涉及      |
| execute_times | Integer | **参数解释**: 执行次数 **取值范围**: 不涉及      |
   
 表11AssociateIssueInfoVo 
| 参数           | 参数类型    | 描述                                                                                                                                                              |
|:---|:---|:---|
| associate    | Boolean | **参数解释**: 是否已关联 **取值范围**: true: 已关联 false:未关联 |
| issue_id     | String  | **参数解释**: 需求ID **取值范围**: 不涉及                  |
| tracker_id   | String  | **参数解释**: 需求类型 **取值范围**: 不涉及                  |
| board_id     | String  | **参数解释**: 工作项层级ID **取值范围**: 不涉及               |
| tracker_name | String  | **参数解释**: 需求类型名称 **取值范围**: 不涉及                |
   
 表12AssociateDefectInfoVo 
| 参数              | 参数类型    | 描述                                                                                                                                                             |
|:---|:---|:---|
| associate       | Boolean | **参数解释**: 是否已关联 **取值范围**: true:已关联 false:未关联 |
| associate_count | Integer | **参数解释**: 关联缺陷数 **取值范围**: 不涉及                |
   
 表13CustomFieldVo 
| 参数                 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| type               | String | **参数解释**: 字段类型 **取值范围**: - 单行文本text   - 多行文本textArea   - 单选框radio   - 多选框checkBox   - 日期date   - 数字number   - 单选用户user    |
| value              | String | **参数解释**: 测试用例自定义字段值 **取值范围**: 字符串类型                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| custom_field_param | String | **参数解释**: 项目用例自定义字段入参或者返回参数名称 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| user_name          | String | **参数解释**: 用户名 **取值范围**: user类型测试用例自定义字段对应用户名，其它类型字段不返回                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   
**状态码：400**
表14响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                  |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：401**
表15响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                  |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：404**
表16响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                  |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：500**
表17响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                  |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
#### 请求示例
查询用例列表
```
post https://{endpoint}/v4/db186d87a311475f9fb926f0b27c495f/testcases/batch-query
{
  "page_no" : 1,
  "page_size" : 15,
  "feature_uri" : "db186d87a311475f9fb926f0b27c495f",
  "service_type" : -1,
  "stage_type" : "3",
  "custom_field_info" : [ ],
  "version_uri" : "v92t00010e47vi9c"
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "total" : 7,
  "value" : [ {
    "uri" : "v90200010sa1snjj",
    "name" : "添加的用例_3050_0431_0435",
    "owner" : {
      "id" : ""
    },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "106",
    "rank_id" : "2",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "3c913532482340e69b9b724f6732c67c",
    "service_type" : {
      "id" : "0",
      "name" : "手工测试"
    },
    "test_type" : {
      "id" : 1,
      "name" : "功能性测试"
    },
    "create_info" : {
      "time" : "2025-10-20 16:58:53",
      "timestamp" : 1760950733000,
      "user_id" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
      "user_name" : "TMSS001_ShylaChen"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "is_test_design" : false,
    "last_modified" : 1760950733000,
    "review_status" : 0,
    "case_create_date" : 1760950733000
  }, {
    "uri" : "v90100010sa1sj6t",
    "name" : "添加的用例_3050_0431",
    "owner" : {
      "id" : ""
    },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "105",
    "rank_id" : "2",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "3c913532482340e69b9b724f6732c67c",
    "service_type" : {
      "id" : "0",
      "name" : "手工测试"
    },
    "test_type" : {
      "id" : 1,
      "name" : "功能性测试"
    },
    "create_info" : {
      "time" : "2025-10-20 16:58:48",
      "timestamp" : 1760950728000,
      "user_id" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
      "user_name" : "TMSS001_ShylaChen"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "is_test_design" : false,
    "last_modified" : 1760950728000,
    "review_status" : 0,
    "case_create_date" : 1760950728000
  }, {
    "uri" : "v90200010s9vut4n",
    "name" : "添加的用例_3050",
    "owner" : {
      "id" : ""
    },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "104",
    "rank_id" : "2",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "3c913532482340e69b9b724f6732c67c",
    "service_type" : {
      "id" : "0",
      "name" : "手工测试"
    },
    "test_type" : {
      "id" : 1,
      "name" : "功能性测试"
    },
    "create_info" : {
      "time" : "2025-10-20 16:25:07",
      "timestamp" : 1760948707000,
      "user_id" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
      "user_name" : "TMSS001_ShylaChen"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "is_test_design" : false,
    "last_modified" : 1760948707000,
    "review_status" : 0,
    "case_create_date" : 1760948707000
  }, {
    "uri" : "v90100010s46cu6q",
    "name" : "新建三方类型的",
    "owner" : {
      "id" : ""
    },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "102",
    "rank_id" : "2",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "3c913532482340e69b9b724f6732c67c",
    "service_type" : {
      "id" : "10004",
      "name" : "新建三方"
    },
    "test_type" : {
      "id" : 1,
      "name" : "功能性测试"
    },
    "create_info" : {
      "time" : "2025-10-18 10:22:12",
      "timestamp" : 1760754132000,
      "user_id" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
      "user_name" : "TMSS001_ShylaChen"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "is_test_design" : false,
    "last_modified" : 1760754132000,
    "review_status" : 0,
    "case_create_date" : 1760754132000
  }, {
    "uri" : "v90100010s45qt1e",
    "name" : "添加的用例",
    "owner" : {
      "id" : ""
    },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "101",
    "rank_id" : "2",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "3c913532482340e69b9b724f6732c67c",
    "service_type" : {
      "id" : "0",
      "name" : "手工测试"
    },
    "test_type" : {
      "id" : 1,
      "name" : "功能性测试"
    },
    "create_info" : {
      "time" : "2025-10-18 10:12:21",
      "timestamp" : 1760753541000,
      "user_id" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
      "user_name" : "TMSS001_ShylaChen"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "is_test_design" : false,
    "last_modified" : 1760753541000,
    "review_status" : 0,
    "case_create_date" : 1760753541000
  }, {
    "uri" : "v90200010rvln3tf",
    "name" : "样例功能用例",
    "owner" : { },
    "status" : {
      "id" : "7",
      "name" : "完成"
    },
    "result" : {
      "id" : "0",
      "name" : "成功"
    },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "008",
    "rank_id" : "2",
    "is_keyword" : false,
    "report_url" : "",
    "project_uuid" : "3c913532482340e69b9b724f6732c67c",
    "service_type" : {
      "id" : "0",
      "name" : "手工测试"
    },
    "test_type" : {
      "id" : 1,
      "name" : "功能性测试"
    },
    "create_info" : {
      "time" : "2025-10-16 16:13:42",
      "timestamp" : 1760602422000,
      "user_id" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
      "user_name" : "TMSS001_ShylaChen"
    },
    "execute_info" : {
      "time" : "2025-10-16 16:13:44",
      "timestamp" : 1760602424000,
      "user_id" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
      "user_name" : "TMSS001_ShylaChen",
      "execute_times" : 1
    },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "is_test_design" : false,
    "last_modified" : 1760602423000,
    "review_status" : 0,
    "case_create_date" : 1760602422000
  }, {
    "uri" : "v90100010rvln2a5",
    "name" : "样例接口用例",
    "owner" : { },
    "status" : {
      "id" : "0",
      "name" : "新建"
    },
    "result" : { },
    "module" : {
      "id" : "",
      "name" : ""
    },
    "iteration" : { },
    "number" : "10010",
    "rank_id" : "2",
    "is_keyword" : false,
    "script_url" : "ApiTest/Scrum_alpha/src/scripts/user/Case_24ed2904867e4325befbf016ef4d8048_1.java",
    "report_url" : "",
    "project_uuid" : "3c913532482340e69b9b724f6732c67c",
    "service_type" : {
      "id" : "1",
      "name" : "接口自动化"
    },
    "test_type" : {
      "id" : 1,
      "name" : "功能性测试"
    },
    "create_info" : {
      "time" : "2025-10-16 16:13:40",
      "timestamp" : 1760602420000,
      "user_id" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
      "user_name" : "TMSS001_ShylaChen"
    },
    "execute_info" : { },
    "associate_issue_info" : {
      "associate" : false
    },
    "associate_defect_info" : {
      "associate" : false
    },
    "case_type" : 0,
    "labels" : [ ],
    "is_test_design" : false,
    "last_modified" : 1760602420000,
    "review_status" : 0,
    "case_create_date" : 1760602420000
  } ],
  "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)。
