
# 根据用例uri查询用例是否存在 - ShowExistTestCaseUris
#### 功能介绍
此接口根据传入的一个或多个用例uri,查询是否存在该用例,返回存在的用例uri
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /v4/testcase/exists
#### 请求参数
表1请求Body参数 
| 参数           | 是否必选 | 参数类型             | 描述                                                                                                                 |
|:---|:---|:---|:---|
| case_uris    | 是    | Array of strings | 用例uri数组                                                                                                            |
| version_uri  | 否    | String           | 分支\&迭代uri                                                                                                          |
| project_uuid | 是    | String           | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) |
   
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数             | 参数类型                                                                                   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|
| status         | String                                                                                 | **参数解释**: 调用此接口的响应状态。 **取值范围**: - success，表示接口调用成功。   - error，表示接口调用失败。    |
| result         | [ResultValueListString] object | 请求返回的数据                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| error          | [ApiError] object                           | 错误信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| request_id     | String                                                                                 | 由接口调用方传入，建议使用UUID保证请求的唯一性。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| server_address | String                                                                                 | 本次请求的受理的服务地址                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   
 表3ResultValueListString 
| 参数        | 参数类型             | 描述                             |
|:---|:---|:---|
| total     | Integer          | 起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值 |
| value     | Array of strings | 实际的数据类型：单个对象，集合 或 NULL         |
| reason    | String           | 业务失败的提示内容                      |
| page_size | Integer          | 分页大小                           |
| page_no   | Integer          | 分页编码                           |
| has_more  | Boolean          | 是否有更多                          |
   
 表4ApiError 
| 参数     | 参数类型   | 描述        |
|:---|:---|:---|
| code   | String | 响应码       |
| reason | String | 业务失败的提示内容 |
   
#### 请求示例
```
post https://{endpoint}/v4/testcase/exists
{
  "case_uris" : [ "v90100010q4flsj1" ],
  "version_uri" : "v90200010ovl7ss9",
  "project_uuid" : "9c115c0e26ee492386cfa408f7e8ed92"
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "result" : [ "001rv9521lf1" ]
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。
