# 搜索特性树 - SearchFeatures
#### 功能介绍
此接口用于搜索特性目录,同页面 测试 -\> 测试用例 -\> 右侧特性目录列表
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /v4/features/search
#### 请求参数
表1请求Body参数 
| 参数           | 是否必选 | 参数类型    | 描述                                                                                                                 |
|:---|:---|:---|:---|
| version_uri  | 是    | String  | 版本URI                                                                                                              |
| project_uuid | 是    | String  | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) |
| parent_uri   | 否    | String  | 父节点URI                                                                                                             |
| key_word     | 是    | String  | 搜索关键字                                                                                                              |
| page_no      | 是    | Integer | 当前页                                                                                                                |
| page_size    | 是    | Integer | 每页条数                                                                                                               |
   
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数        | 参数类型                                                                            | 描述      |
|:---|:---|:---|
| value     | Array of [SearchTestItemVo] objects | 请求返回的数据 |
| total     | Integer                                                                         | 总数      |
| page_size | Integer                                                                         | 分页大小    |
| page_no   | String                                                                          | 分页编码    |
   
 表3SearchTestItemVo 
| 参数                      | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| uri                     | String  | 资源URI                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| type                    | String  | **参数解释**: 资源类型 **取值范围**: - TestCase，用例。   - Task，任务。   - TestVersion，分支。   - IteratorTestCase，迭代用例。    |
| author                  | String  | 创建人                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| name                    | String  | 名称                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| rank                    | Integer | 级别                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| owner                   | String  | 责任人                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| frequence               | String  | frequence值                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| region                  | String  | 区域                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| last_modifier           | String  | 最后修改人                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| last_modified           | String  | 最后修改时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| last_modified_timestamp | Long    | 修改时间时间戳                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| last_change_time        | String  | 最后变更时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| version_uri             | String  | 版本URI                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| origin_uri              | String  | 源资源URI                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| parent_uri              | String  | 父资源URI                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| parent_path             | String  | 父资源路径                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| creation_version_uri    | String  | 创建版本URI                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| creation_date           | String  | 创建时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| creation_date_timestamp | Long    | 创建时间时间戳                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| author_name             | String  | 创建人名称                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| comment                 | String  | 备注                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| number                  | String  | 编号                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| is_feature              | String  | 是否特性                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| relate_htsm             | String  | 是否关联特性                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| aw_unique_id            | String  | aw id                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| test_mind_id            | String  | 脑图id                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| test_mind_url           | String  | 脑图url                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| project_uuid            | String  | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| path_name               | String  | 路径名称                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   
**状态码：400**
表4响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                       |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：401**
表5响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                       |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：404**
表6响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                       |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：500**
表7响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                       |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
#### 请求示例
```
post https://{endpoint}/v4/features/search
{
  "project_uuid" : "9a5b66157ff44f6f80ce5f0fd1709f21",
  "version_uri" : "v92s00010cmov0d6",
  "key_word" : "aaa",
  "parent_uri" : null,
  "page_size" : 50,
  "page_no" : 1
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "total" : 1,
  "value" : [ {
    "uri" : "v90100010qmb5kjn",
    "type" : "TestItem",
    "author" : "307262de1b3c485f9f74b8b9eec2ce37",
    "name" : "子目录333",
    "region" : "roma-devx-3",
    "last_modifier" : "307262de1b3c485f9f74b8b9eec2ce37",
    "last_modified" : "2025-09-30 15:00:31",
    "last_modified_timestamp" : 1759215631993,
    "last_change_time" : "2025-09-30 15:00:31",
    "version_uri" : "v90100010qgqgiub",
    "parent_uri" : "v90100010qgqgiub",
    "parent_path" : "/9d582bcc292a491e8d4d4c551102e70b/v90100010qgqgiub/",
    "creation_version_uri" : "v90100010qgqgj10",
    "creation_date" : "2025-09-30 15:00:31",
    "is_feature" : "0",
    "relate_htsm" : "0"
  } ],
  "page_size" : 50,
  "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)。