
# 添加目录信息 - AddFeatureAll
#### 功能介绍
此接口用于添加目录信息，同页面 测试 -\> 测试用例 -\> 右侧展示用例的目录列表，右键点击目录，即可点击新建目录
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
POST /GT3KServer/v4/features
#### 请求参数
表1请求Body参数 
| 参数                    | 是否必选 | 参数类型    | 描述                                                                                                                 |
|:---|:---|:---|:---|
| comment               | 否    | String  | 备注                                                                                                                 |
| name                  | 是    | String  | 名称                                                                                                                 |
| number                | 否    | String  | 编号                                                                                                                 |
| owner                 | 否    | String  | 责任人                                                                                                                |
| is_feature            | 否    | String  | 是否为特性,1:特性 2:目录                                                                                                    |
| project_uuid          | 是    | String  | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) |
| parent_uri            | 否    | String  | 父节点uri                                                                                                             |
| version_uri           | 否    | String  | 版本URI                                                                                                              |
| ignore_duplicate_name | 否    | Boolean | 是否忽略名称重复                                                                                                           |
   
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数    | 参数类型                                                     | 描述      |
|:---|:---|:---|
| value | [TestItemVo] object | 请求返回的数据 |
   
 表3TestItemVo 
| 参数                      | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| uri                     | String  | **参数解释**: 资源URI **取值范围**: 11-34位的字母及数字（字符串）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| type                    | String  | **参数解释**: 资源类型 **取值范围**: - TestCase，用例。   - Task，任务。   - TestVersion，分支。   - IteratorTestCase，迭代用例。    |
| author                  | String  | **参数解释**: 创建人 **取值范围**: 字符串类型，长度小于128个字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| name                    | String  | **参数解释**: 名称 **取值范围**: 字符串类型，长度小于128个字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| rank                    | Integer | **参数解释**: 级别 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| owner                   | String  | **参数解释**: 责任人 **取值范围**: 字符串类型，长度小于128个字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| frequence               | String  | **参数解释**: frequence值 **取值范围**: 字符串类型，长度小于128个字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| region                  | String  | **参数解释**: 区域 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| last_modifier           | String  | **参数解释**: 最后修改人 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| last_modified           | String  | **参数解释**: 最后修改时间 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| last_modified_timestamp | Long    | **参数解释**: 修改时间时间戳 **取值范围**: 时间戳格式，单位为毫秒                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| last_change_time        | String  | **参数解释**: 最后变更时间 **取值范围**: 时间格式为"yyyy-MM-dd HH:mm:ss"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| version_uri             | String  | **参数解释**: 版本URI **取值范围**: 11-34位字母、数字组成的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| origin_uri              | String  | **参数解释**: 源资源URI **取值范围**: 11-34位字母、数字组成的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| parent_uri              | String  | **参数解释**: 父资源URI **取值范围**: 11-34位字母、数字组成的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| parent_path             | String  | **参数解释**: 父资源路径 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| creation_version_uri    | String  | **参数解释**: 创建版本URI **取值范围**: 11-34位字母、数字组成的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| creation_date           | String  | **参数解释**: 创建时间 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| creation_date_timestamp | Long    | **参数解释**: 创建时间时间戳 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| author_name             | String  | **参数解释**: 创建人名称 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| comment                 | String  | **参数解释**: 备注 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| number                  | String  | **参数解释**: 编号 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| is_feature              | String  | **参数解释**: 是否特性 **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| relate_htsm             | String  | **参数解释**: 是否关联特性 **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| aw_unique_id            | String  | **参数解释**: aw id **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| test_mind_id            | String  | **参数解释**: 脑图id **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| test_mind_url           | String  | **参数解释**: 脑图url **取值范围**: 长度小于128个字符的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| project_uuid            | String  | **参数解释**: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围**: 32位字母和数字组成的字符串                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| case_total              | Integer | **参数解释**: 用例总数 **取值范围**: 大于等于1的正整数，单位：个                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| execd_total             | Integer | **参数解释**: 执行总数 **取值范围**: 大于等于1的正整数，单位：个                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| is_direct_relation      | Boolean | **参数解释**: is_direct_relation **取值范围**: 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| has_child               | Boolean | **参数解释**: 是否有子特性 **取值范围**: true:是 false:否                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   
**状态码：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}/GT3KServer/v4/features
{
  "name" : "新增子目录(3)",
  "version_uri" : "v9080000v2teq999",
  "parent_uri" : "v9080000v2teq999",
  "project_uuid" : "ffecfceca51d419cbfc2a28e90c93761",
  "number" : ""
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "value" : {
    "uri" : "v92u000108e45gkt",
    "type" : "TestItem",
    "author" : "afd0d050cc2a4d9eb13bd2c71904c1a2",
    "name" : "新增子目录(3)",
    "region" : "cn-north-7",
    "last_modifier" : "afd0d050cc2a4d9eb13bd2c71904c1a2",
    "last_modified" : "2025-02-15 17:41:39",
    "last_modified_timestamp" : 1739612499614,
    "last_change_time" : "2025-02-15 17:41:39",
    "version_uri" : "v9080000v2teq999",
    "parent_uri" : "v9080000v2teq999",
    "parent_path" : "/ffecfceca51d419cbfc2a28e90c93761/v9080000v2teq999/",
    "creation_version_uri" : "v9080000v2teq999",
    "creation_date" : "2025-02-15 17:41:39",
    "creation_date_timestamp" : 1739612499614,
    "relate_htsm" : "0",
    "project_uuid" : "ffecfceca51d419cbfc2a28e90c93761",
    "case_total" : 0,
    "execd_total" : 0,
    "is_direct_relation" : false,
    "has_child" : false
  }
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。
