# 查询用例模板列表 - BatchQueryTemplate
#### 功能介绍
此接口用于查询功能自动化用例的模板列表
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /v4/{project_id}/case-templates/batch-query
表1路径参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) |
#### 请求参数
表2请求Body参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| name | 否 | String | 模板名称 |
| industry_type | 否 | Integer | **参数解释**: 行业类别 **约束限制**: 不涉及 **取值范围**: - 1，通用模板。 - 2，智能汽车。 - 3，智能出行。 - 4，云服务。 - 5，电商。 - 6，网络。 - 7，企业设备。 - 8，芯片。 - 9，智能终端。 - 10，金融。 - 11，音视频。 - 12，游戏。 **默认取值**: 不涉及 |
| is_default | 否 | Boolean | 是否是内置模板 |
#### 响应参数
**状态码：200**
表3响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| total | Integer | 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 |
| value | Array of [TestCaseTemplateVo] objects | 实际的数据类型：单个对象，集合 或 NULL |
| reason | String | 业务失败的提示内容 |
| page_size | Integer | 分页大小 |
| page_no | Integer | 分页编码 |
| has_more | Boolean | 是否有更多 |
表4TestCaseTemplateVo
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| uri | String | 模板uri |
| name | String | 模板名称 |
| description | String | 模板描述 |
| number | String | 用例编号 |
| rank | Integer | 用例等级 |
| preparation | String | 前置条件 |
| creator | String | 创建人 |
| region | String | 逻辑Region |
| updator | String | 修改人 |
| template_test_type | Integer | 模板测试类型(1：性能，2：安全，3：功能，4：韧性可靠性，5：过载场景) |
| service_type | Integer | **参数解释**: 执行类型 **取值范围**: - 0，冒烟。 - 1，定时。 |
| test_type | Integer | **参数解释**: 测试类型 **取值范围**: - 1，性能。 - 2，安全。 - 3，功能。 - 4，韧性可靠性。 - 5，过载场景。 |
| test_step | String | 步骤 |
| expect_output | String | 预期结果 |
| case_name | String | 用例名称 |
| case_description | String | 用例描述 |
| label_list | Array of strings | 标签列表 |
| script_url | String | 脚本路径 |
| creator_name | String | 创建人名称 |
| create_time | String | 创建时间 |
| tenant_id | String | 租户 |
| update_time | String | 修改时间 |
| is_default | Boolean | 是否为内置模板 |
| is_recommended | Boolean | 是否精选模板 |
| industry_type | Integer | **参数解释**: 行业分类id **取值范围**: - 1，通用模板。 - 2，智能汽车。 - 3，智能出行。 - 4，云服务。 - 5，电商。 - 6，网络。 - 7，企业设备。 - 8，芯片。 - 9，智能终端。 - 10，金融。 - 11，音视频。 - 12，游戏。 |
| is_solution_template | Boolean | 是否解决方案模板 |
| solution_template_uri | String | 解决方案模板URI |
| feature_uri | String | 目录URI |
| steps | Array of [TestCaseStepVo] objects | 测试步骤 |
表5TestCaseStepVo
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| test_step | String | 测试步骤 |
| expect_result | String | 预期结果 |
**状态码：400**
表6响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | 接口调用失败错误码 |
| error_msg | String | 接口调用失败错误信息 |
**状态码：401**
表7响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | 接口调用失败错误码 |
| error_msg | String | 接口调用失败错误信息 |
**状态码：404**
表8响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | 接口调用失败错误码 |
| error_msg | String | 接口调用失败错误信息 |
**状态码：500**
表9响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | 接口调用失败错误码 |
| error_msg | String | 接口调用失败错误信息 |
#### 请求示例
```
post https://{endpoint}/v4/807aed221bf5457c8ccbbc55597d9a38/case-templates/batch-query
{
"is_default" : true
}
```
#### 响应示例
**状态码：200**
OK
```
{
"value" : [ {
"uri" : "62",
"name" : "股票停牌卖出撤单测试",
"description" : "本用例用于股票停牌后，在进行创业板/科创板交易测试",
"number" : "Finance_Stock_Trading_001",
"rank" : 2,
"preparation" : "1、存在创业板/科创板持仓",
"service_type" : 0,
"test_type" : 1,
"test_step" : "[\"15：00之前卖出停牌的股票
\",\"15：00之后卖出停牌的股票
\",\"15：00之前卖出停牌的股票
\",\"15：00之后卖出停牌的股票
\"]",
"expect_output" : "[\"能进行卖出和撤单
\",\"不能进行卖出
\",\"能进行卖出和撤单
\",\"不能进行卖出
\"]",
"case_name" : "股票停牌_卖出_撤单测试",
"case_description" : "本用例用于股票停牌后，在进行创业板/科创板交易测试",
"label_list" : [ "金融", "停牌交易", "卖出撤单" ],
"script_url" : "",
"create_time" : "2022-06-27 19:50:01",
"update_time" : "2022-06-27 19:50:00",
"is_default" : true,
"is_recommended" : false,
"industry_type" : 10,
"is_solution_template" : false,
"steps" : [ {
"test_step" : "15：00之前卖出停牌的股票
",
"expect_result" : "能进行卖出和撤单
"
}, {
"test_step" : "15：00之后卖出停牌的股票
",
"expect_result" : "不能进行卖出
"
}, {
"test_step" : "15：00之前卖出停牌的股票
",
"expect_result" : "能进行卖出和撤单
"
}, {
"test_step" : "15：00之后卖出停牌的股票
",
"expect_result" : "不能进行卖出
"
} ]
} ]
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
| 404 | Not Found |
| 500 | Internal Server Error |
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。