# 批量查询子任务用例 - ListSubTestCaseByConditionsUsing
#### 功能介绍
批量查询子任务用例
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /v1/projects/{service_id}/testsuite/results/cases
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| service_id | 是    | String | 服务id |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                            |
|:---|:---|:---|:---|
| X-Auth-Token | 否    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
表3请求Body参数 
| 参数              | 是否必选 | 参数类型              | 描述                          |
|:---|:---|:---|:---|
| create_user     | 否    | String            | 用例创建者                       |
| endTime         | 否    | Long              | 用例结束时间                      |
| keyWord         | 否    | String            | 模糊查询关键字                     |
| location_id     | 否    | String            | 执行机区域ID                     |
| more            | 否    | Boolean           | 查询结果是否还有更多数据的标志             |
| page_num        | 否    | Integer           | 分页时页码                       |
| page_size       | 否    | Integer           | 分页时每页大小                     |
| pid             | 否    | String            | 告警策略选择失败后重试时有值              |
| results         | 否    | Array of integers | cloudTest任务执行结果列表           |
| sortBy          | 否    | String            | 排序字段                        |
| stage           | 否    | Integer           | 用例所处的阶段 0：前置， 1：测试用例 2：后置用例 |
| startTime       | 否    | Long              | 用例开始时间                      |
| state           | 否    | String            | 状态                          |
| subtask_ids     | 否    | Array of strings  | 子任务ID列表                     |
| subtask_id      | 否    | String            | 子任务ID                       |
| suiteType       | 否    | Integer           | 商用测试套类型                     |
| task_id         | 否    | String            | 任务ID                        |
| task_ids        | 否    | Array of strings  | 任务ID列表                      |
| taskTypeId      | 否    | String            | 任务类型                        |
| taskid          | 否    | String            | 任务ID                        |
| test_service_id | 否    | String            | 服务ID                        |
| testcase_id     | 否    | String            | 用例ID                        |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数                | 参数类型              | 描述                 |
|:---|:---|:---|
| end_row           | Long              | 当前页面最后一个元素在数据库中的行号 |
| has_next_page     | Boolean           | 是否有下一页             |
| has_previous_page | Boolean           | 是否有前一页             |
| is_first_page     | Boolean           | 是否为第一页             |
| is_last_page      | Boolean           | 是否为最后一页            |
| list              | Array of objects  | 返回结果               |
| navigateFirstPage | Integer           | 导航条上的第一页           |
| navigateLastPage  | Integer           | 导航条上的最后一页          |
| navigate_pages    | Integer           | 导航页码数              |
| navigatepageNums  | Array of integers | 所有导航页号             |
| next_page         | Integer           | 下一页                |
| page_num          | Integer           | 当前页                |
| page_size         | Integer           | 每页的数量              |
| pages             | Integer           | 总页数                |
| pre_page          | Integer           | 前一页                |
| size              | Integer           | 当前页的数量             |
| start_row         | Long              | 当前页面第一个元素在数据库中的行号  |
| total             | Long              | 总条数                |
   
**状态码：201**
Created
**状态码：401**
表5响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误编码 |
| error_msg  | String | 错误原因 |
   
**状态码：403**
表6响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误编码 |
| error_msg  | String | 错误原因 |
   
**状态码：404**
表7响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误编码 |
| error_msg  | String | 错误原因 |
   
#### 请求示例
```
post https://{endpoint}/v1/projects/4858a39d9861476ca2cbc71db0d5db2e/testsuite/results/cases
{
  "create_user" : "zx12513135",
  "location_id" : "021313002",
  "more" : true,
  "page_num" : 1,
  "page_size" : 10,
  "pid" : "168263031256",
  "stage" : 1,
  "state" : "gamma",
  "subtask_ids" : [ "165121313" ],
  "subtask_id" : "3516541320",
  "suiteType" : 0,
  "task_id" : "cfasf241352136",
  "task_ids" : [ "casd321032" ],
  "taskTypeId" : "ads351352",
  "taskid" : "csZc2s1032",
  "test_service_id" : "fcas1df2s3a1",
  "testcase_id" : "cvaszcv163sd1"
}
```
#### 响应示例
**状态码：200**
OK
```
pageNum: 1
pageSize: 15
sortBy: startTime
suiteType: 1
subtaskId: da3ee5c098044a42924b491a49e1e72a
taskTypeId: '2'
taskId: v92u00011gacv6j8
results: []
startTime: 1782437202382
stage: 1
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | OK           |
| 201 | Created      |
| 401 | Unauthorized |
| 403 | Forbidden    |
| 404 | Not Found    |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。