# 查询用例 - ShowCase
#### 功能介绍
查询用例
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CPTS/doc?api=ShowCase)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cpts/cpts_api_0019.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                                      | 访问级别 | 资源类型（\*为必须） | 条件键                       | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | codeartsperftest:cpts:getPerfTestProject | Read | cpts \*     | g:ResourceTag/\<tag-key\> | -  | -      |
     
  
 
#### URI
GET /v2/{project_id}/test-cases/{case_id}
表1路径参数 
| 参数         | 是否必选 | 参数类型    | 描述                                                                              |
|:---|:---|:---|:---|
| case_id    | 是    | Integer | 用例ID，通过"创建用例"接口获取响应体中的json.test_case_id字段的值。                                    |
| project_id | 是    | String  | 表示项目ID，参见[获取方法说明](https://support.huaweicloud.com/api-cpts/cpts_api_0017.html)。 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数        | 参数类型                                                        | 描述   |
|:---|:---|:---|
| code      | String                                                      | 响应码  |
| message   | String                                                      | 响应消息 |
| test_case | [CaseInfoDetail] object | 用例详情 |
   
 表3CaseInfoDetail 
| 参数                 | 参数类型                                                                | 描述                                           |
|:---|:---|:---|
| name               | String                                                              | 用例名称                                         |
| case_type          | Integer                                                             | 用例类型（0：常规用例）                                 |
| contents           | Array of [Contents] objects           | 用例脚本信息                                       |
| for_loop_params    | Array of objects                                                    | 旧版本逻辑控制器字段，当前已不使用                            |
| increase_setting   | Array of objects                                                    | 梯度递增                                         |
| stages             | Array of [TestCaseStage] objects | 阶段信息                                         |
| status             | Integer                                                             | 状态（0：已删除；1：启用；2：禁用）                          |
| temp_id            | Integer                                                             | 用例ID，通过"创建用例"接口获取响应体中的json.test_case_id字段的值。 |
| sort               | Integer                                                             | 排序字段                                         |
| directory_id       | Integer                                                             | 用例所属目录ID（旧版接口可不传）                            |
| setup_contents     | Array of [Contents] objects           | 前置步骤                                         |
| user_replicas      | Integer                                                             | 执行器个数                                        |
| collect_log_policy | Integer                                                             | 日志采集策略（0-请求模式；1-用例模式）                        |
| link_app_list      | Array of integers                                                   | 关联全链路应用列表                                    |
| case_info          | [CaseDoc] object                       | 文本用例信息                                       |
   
 表4TestCaseStage 
| 参数                      | 参数类型                                                      | 描述                                                 |
|:---|:---|:---|
| operate_mode            | Integer                                                   | 压力阶段模式（0：时长模式；1：次数模式）                              |
| name                    | String                                                    | 阶段名称                                               |
| time                    | Integer                                                   | 压测时长（单位：秒）                                         |
| start_time              | Integer                                                   | 开始时间                                               |
| end_time                | Integer                                                   | 结束时间                                               |
| issue_num               | Integer                                                   | 最大并发数                                              |
| count                   | Integer                                                   | 次数模式发送总次数                                          |
| pressure_mode           | Integer                                                   | 压力模式（0：并发模式；1：TPS模式；2：摸高模式；3：浪涌模式；5：震荡模式；7：智能摸高模式） |
| tps_value               | Integer                                                   | TPS模式下TPS值                                         |
| current_user_num        | Integer                                                   | 起始并发数                                              |
| current_tps             | Integer                                                   | 起始TPS值                                             |
| voltage_regulating_mode | Integer                                                   | 调压模式（0：自动调压模式；1：手动调压模式）                            |
| maximum                 | Integer                                                   | 震荡/浪涌模式下最大并发数                                      |
| minimum                 | Integer                                                   | 震荡/浪涌模式下最小并发数                                      |
| loop_count              | Integer                                                   | 震荡/浪涌次数                                            |
| max_duration            | Integer                                                   | 浪涌模式下峰值持续时间                                        |
| ramp_up                 | Integer                                                   | 摸高模式下爬坡时长（单位：秒）                                    |
| peak_load_kpis          | [StageKpiItems] object | 摸高指标                                               |
| step_duration           | Integer                                                   | 智能摸高模式下单步执行时长                                      |
| step_size               | Integer                                                   | 智能摸高模式下递增并发数                                       |
   
 表5StageKpiItems 
| 参数                    | 参数类型                                                    | 描述     |
|:---|:---|:---|
| average_response_time | [StageKpiItem] object | 平均响应时间 |
| success_rate          | [StageKpiItem] object | 成功率    |
   
 表6StageKpiItem 
| 参数         | 参数类型    | 描述  |
|:---|:---|:---|
| comparison | String  | 比较符 |
| value      | Integer | 比较值 |
   
 表7Contents 
| 参数                 | 参数类型                                                    | 描述                                                                                 |
|:---|:---|:---|
| content_id         | Integer                                                 | 事务ID，通过"创建事务"接口获取响应体中的tempId字段的值。若不为0表示此卡片为事务；为0表示非事务                              |
| content            | Array of [Content] objects | 内容                                                                                 |
| index              | Integer                                                 | 排序索引标识                                                                             |
| selected_temp_name | String                                                  | 选择的事务或者用例名称                                                                        |
| data               | Object                                                  | 数据（循环、条件控制器作用的数据）                                                                  |
| data_type          | Integer                                                 | 数据指令类型（0：默认请求卡片；1：数据指令；201：循环指令；202：条件指令；301：集合点；203：vu百分比控制器；204：吞吐量控制器；302：插件请求） |
| conditions         | Object                                                  | 若类型为"202：条件指令"，该字段为条件配置                                                            |
| is_disabled        | Boolean                                                 | 是否禁用                                                                               |
   
 表8Content 
| 参数           | 参数类型                                                  | 描述                               |
|:---|:---|:---|
| content_type | Integer                                               | 用例卡片类型（1：思考时间；2：报文；3：检查点；4：变量提取） |
| content      | [ContentInfo] object | 内容                               |
   
 表9ContentInfo 
| 参数                   | 参数类型                                                                | 描述                                                                          |
|:---|:---|:---|
| body_type            | Integer                                                             | body类型（0：字符串；1：form-data格式；3：x-www-form-urlencoded格式）                       |
| bodys                | Array of objects                                                    | 请求体                                                                         |
| check_end_length     | Object                                                              | TCP/UDP协议返回数据长度                                                             |
| check_end_str        | Object                                                              | TCP/UDP协议返回结束符                                                              |
| check_end_type       | Object                                                              | TCP/UDP协议返回结束类型（1：返回数据长度；2：结束符）                                             |
| connect_timeout      | Integer                                                             | 超时时间                                                                        |
| connect_type         | Integer                                                             | 连接设置，当前版本已不使用                                                               |
| headers              | Array of [ContentHeader] objects | 请求头                                                                         |
| http_version         | String                                                              | HTTP版本                                                                      |
| method               | String                                                              | HTTP方法                                                                      |
| name                 | String                                                              | 用例名称                                                                        |
| protocol_type        | Integer                                                             | 协议类型（1：HTTP；2：HTTPS；3：TCP；4：UDP；7：HLS/RTMP；9：WebSocket；10：HTTP-FLV；11：MQTT） |
| return_timeout       | Integer                                                             | 响应超时                                                                        |
| return_timeout_param | String                                                              | 响应超时参数                                                                      |
| url                  | String                                                              | 请求地址                                                                        |
| rtmp_url             | String                                                              | rtmp地址                                                                      |
| flv_url              | String                                                              | flv地址                                                                       |
| bitrate_type         | Integer                                                             | 分辨率策略                                                                       |
| duration             | Integer                                                             | 持续时间                                                                        |
| retry_delay          | Integer                                                             | HLS重试延迟时间                                                                   |
| retry_time           | Integer                                                             | HLS重试次数                                                                     |
   
 表10ContentHeader 
| 参数    | 参数类型   | 描述 |
|:---|:---|:---|
| key   | String | 键  |
| value | String | 值  |
   
 表11CaseDoc 
| 参数          | 参数类型                                                | 描述                             |
|:---|:---|:---|
| description | String                                              | 用例描述信息                         |
| label_names | Array of strings                                    | 标签                             |
| preparation | String                                              | 前置条件                           |
| rank        | Integer                                             | 用例等级（0-L0；1-L1；2-L2；3-L3；4-L4） |
| status_code | Integer                                             | 状态（0-新建；5-设计中；6-测试中；7-完成）      |
| steps       | Array of [steps] objects | 测试步骤                           |
   
 表12steps 
| 参数            | 参数类型   | 描述   |
|:---|:---|:---|
| expect_result | String | 步骤描述 |
| test_step     | String | 预期结果 |
   
#### 请求示例
查询一个用例的详情信息，用例的id是1。
```
/v2/{project_id}/test-cases/1
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | 用例详情响应对象 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cpts/ErrorCode.html)。