# 添加自定义工作项模块 - CreateModule
#### 功能介绍
添加自定义工作项模块。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST /v2/module/modules
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 不涉及。 **取值范围：** 长度为10\~32768个字符。 **默认取值：** 不涉及。 |
   
表2请求Body参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| description   | 否    | String | **参数解释：** 这是一个描述字段，用来提供关于该项目或任务的更多细节。 **约束限制：** 不涉及。 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                          |
| name          | 否    | String | **参数解释：** 工作项模块的名称。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                                                                                                                                          |
| owner         | 否    | String | **参数解释：** 模块的负责人数字id，通过[获取指定项目的成员用户列表](https://support.huaweicloud.com/api-projectman/ListProjectMembersV4.html)接口获取，响应消息体中的**user_num_id**字段的值就是模块的负责人数字id。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| project_id    | 否    | String | **参数解释**： 项目的32位uuid，项目唯一标识，通过[查询项目列表](https://support.huaweicloud.com/api-projectman/ListProjectsV4.html)接口获取，响应消息体中的**project_id**字段的值就是项目ID。 **约束限制**： 32位的数字和字母组成的字符串。 **取值范围**： 不涉及。 **默认取值**： 不涉及。  |
| parent_num_id | 否    | String | **参数解释：** 用于表示父级任务的唯一标识，通过[查询模块设置](https://support.huaweicloud.com/api-projectman/ListModules.html)接口获取，响应消息体中的**modules** 里面的**id**的值就是模块ID。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数     | 参数类型                                            | 描述                                                                                                                             |
|:---|:---|:---|
| result | [result] object | **参数解释：** 返回的结果。                                                                               |
| status | String                                          | **参数解释：** 结果状态。 **取值范围：** 不涉及。 |
   
 表4result 
| 参数     | 参数类型                                            | 描述                                                 |
|:---|:---|:---|
| module | [module] object | **参数解释：** 模块的详细信息。 |
   
 表5module 
| 参数          | 参数类型                                              | 描述                                                                                                                                |
|:---|:---|:---|
| description | String                                            | **参数解释：** 模块的描述。 **取值范围：** 不涉及。   |
| id          | Integer                                           | **参数解释：** 模块的id。 **取值范围：** 不涉及。   |
| name        | String                                            | **参数解释：** 模块的名称。 **取值范围：** 不涉及。   |
| owner       | [owner] object     | **参数解释：** 模块的拥有者。                                                                                 |
| project     | [project] object | **参数解释：** 项目信息。                                                                                   |
| path        | String                                            | **参数解释：** 模块的路径。 **取值范围：** 不涉及。   |
| path_name   | String                                            | **参数解释：** 模块路径的名称。 **取值范围：** 不涉及。 |
   
 表6owner 
| 参数         | 参数类型    | 描述                                                                                                                                |
|:---|:---|:---|
| id         | Integer | **参数解释：** 拥有者的数字id。 \**取值范围：不涉及*                                  |
| name       | String  | **参数解释：** 拥有者的用户名。 **取值范围：** 不涉及。 |
| identifier | String  | **参数解释：** 拥有者的id。 \*\*取值范围： 不涉及。  |
| nick_name  | String  | **参数解释：** 拥有者的昵称。 **取值范围：** 不涉及。  |
   
 表7project 
| 参数         | 参数类型    | 描述                                                                                                                                   |
|:---|:---|:---|
| id         | Integer | **参数解释：** 项目数字id。 **取值范围：** 不涉及。     |
| identifier | String  | **参数解释：** 项目的唯一标识符id。 **取值范围：** 不涉及。 |
| name       | String  | **参数解释：** 项目的名称。 **取值范围：** 不涉及。      |
| type       | String  | **参数解释：** 项目的类型。 **取值范围：** 不涉及。      |
   
#### 请求示例
```
POST http://{endpoint}/v2/module/modules?_=1753684289689
{
  "description" : "",
  "name" : "阿萨达",
  "owner" : "4091",
  "project_id" : "5192de5eb435430c8cd41c6ae6028848",
  "parent_num_id" : ""
}
```
#### 响应示例
**状态码：200**
```
{
  "result" : {
    "module" : {
      "description" : "",
      "id" : 886637,
      "name" : "阿萨达",
      "owner" : {
        "id" : 4091,
        "name" : "devcloud_devcloud_s00404480_01",
        "identifier" : "a360371833bf4c558f796fd707b44daf",
        "nick_name" : "张三丰1"
      },
      "project" : {
        "id" : 35138974,
        "identifier" : "5192de5eb435430c8cd41c6ae6028848",
        "name" : "DevOps全流程示例项目XXXX",
        "type" : "scrum"
      },
      "path" : "886637",
      "path_name" : "阿萨达"
    }
  },
  "status" : "success"
}
```
#### 状态码
| 状态码 | 描述                 |
|:---|:---|
| 200 | 添加自定义工作项模板接口成功的响应。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。