# 思维导图中创建工作项 - CreateEpicIssue
#### 功能介绍
思维导图中创建工作项。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST /v2/issues/create
#### 请求参数
表1请求Body参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| projectUUId | 否 | String | **参数解释**： 项目的32位uuid，项目唯一标识，通过[查询项目列表](https://support.huaweicloud.com/api-projectman/ListProjectsV4.html)接口获取，响应消息体中的**project_id**字段的值就是项目ID。 **约束限制**： 32位的数字和字母组成的字符串。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| tracker_id | 否 | Integer | **参数解释**： 工作项类型。 **约束限制**： 不涉及。 **取值范围**： 2（任务/Task） 3（缺陷/Bug） 5（Epic） 6（Feature） 7（Story） **默认取值**： 不涉及。 |
| priority_id | 否 | Integer | **参数解释：** 优先级id 。 **约束限制：** 不涉及。 **取值范围：** 1（低） 2（中） 3（高） **默认取值：** 不涉及。 |
| subject | 否 | String | **参数解释：** 工作项名称。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| parent_issue_id | 否 | Integer | **参数解释：** 父工作项id，可通过[高级查询工作项](https://support.huaweicloud.com/api-projectman/ListIssuesV4.html)接口获取，响应消息体中的**id**字段的值就是工作项id。 **约束限制：** 长度在1位到10位之间的纯数字。 **取值范围：** 最小长度：1，最大长度：10。 **默认取值：** 不涉及。 |
| description | 否 | String | **参数解释：** 工作项描述。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| due_date | 否 | Integer | **参数解释：** 工作项的截止日期（时间戳格式，示例：1839340800000）。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| start_date | 否 | Integer | **参数解释：** 工作项的开始日期（时间戳格式，示例：1839340800000）。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| severity_id | 否 | Integer | **参数解释：** 重要程度id 。 **约束限制：** 不涉及。 **取值范围：** 10 （关键） 11 （重要） 12 （一般） 13 （提示） **默认取值：** 不涉及。 |
| done_ratio | 否 | Integer | **参数解释：** 工作项的完成度。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 |
| status_id | 否 | Integer | **参数解释**： 状态id。 **约束限制**： 不涉及。 **取值范围**： 1（新建） 2（进行中） 3（已解决） 4（测试中） 5（已关闭） 6（已拒绝）。 **默认取值**： 不涉及。 |
| expected_work_hours | 否 | Integer | **参数解释：** 工作项的预计工时（单位：人/时）。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
| plan_id | 否 | String | **参数解释：** 规划的id，通过[分页查询当前项目用户可见的所有规划](https://support.huaweicloud.com/api-projectman/ShowScrumPlansByCondition.html)接口获取，响应消息体中的**id**字段的值就是规划的id。 **约束限制**： 32位的数字和字母组成的字符串。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
#### 响应参数
**状态码：200**
表2响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| result | [result] object | **参数解释：** 思维导图中创建工作项的返回结果。 |
| status | String | **参数解释：** 思维导图中创建工作项的返回状态。 **取值范围：** success：返回成功。 error：返回失败。 |
表3result
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| issue | [IssueNew] object | **参数解释：** 工作项信息。 |
表4IssueNew
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| updated_on | String | **参数解释：** 工作项的更新日期。时间戳格式（示例：1839340800000） 。 **取值范围：** 不涉及。 |
| story_point | [StoryPoint] object | **参数解释：** 工作项的故事点。 **取值范围：** 不涉及。 |
| subject | String | **参数解释：** 工作项的负责者。 **取值范围：** 不涉及。 |
| project | [Project] object | **参数解释：** 项目。 **取值范围：** 不涉及。 |
| isParent | Boolean | **参数解释：** 是否有子工作项。 **取值范围：** true（有子工作项） false（没有子工作项） |
| done_ratio | Integer | **参数解释：** 工作项完成度。 **取值范围：** 不涉及。 |
| findReleaseDev | String | **参数解释：** 发布人 。 **取值范围：** 不涉及。 |
| tracker | [Tracker] object | **参数解释：** 工作项的类型。 **取值范围：** 不涉及。 |
| id | Integer | **参数解释：** 工作项列表id。 **取值范围：** 不涉及。 |
| start_date | String | **参数解释：** 工作项的开始日期。时间戳格式（示例：1839340800000）。 **取值范围：** 不涉及。 |
| assigned_to | [assigned_to] object | **参数解释：** 工作项责任人。 **取值范围：** 不涉及。 |
| status_attribute | [StatusAttributeVO] object | **参数解释：** 工作项的状态属性。 **取值范围：** 不涉及。 |
| severity | [Severity] object | **参数解释：** 重要程度。 **取值范围：** 不涉及。 |
| releaseDev | String | **参数解释：** 工作项发布版本号。 **取值范围：** 不涉及。 |
| author | [author] object | **参数解释：** 工作项负责人。 **取值范围：** 不涉及。 |
| module | Object | **参数解释：** 工作项的模块。 **取值范围：** 不涉及。 |
| due_date | String | **参数解释：** 工作项的截止日期，时间戳格式（示例：1839340800000）。 **取值范围：** 不涉及。 |
| expected_work_hours | Integer | **参数解释：** 工作项的预计工时(单位：人时)。 **取值范围：** 不涉及。 |
| priority | [Priority] object | **参数解释：** 优先级。 **取值范围：** 不涉及。 |
| actual_work_hours | Integer | **参数解释：** 工作项的实际工时（单位：人/时）。 **取值范围：** 不涉及。 |
| is_watcher | Boolean | **参数解释：** 是否关注 。 **取值范围：** true（是） false（不是） |
| deleted | Boolean | **参数解释：** 是否删除 。 **取值范围：** true（是） false（不是） |
| fixed_version | Object | **参数解释：** 问题解决版本。 **取值范围：** 不涉及。 |
| is_archived | Boolean | **参数解释：** 是否归档。 **取值范围：** true（是） false（不是） |
| created_on | String | **参数解释：** 工作项的创建时间，时间戳格式（示例：1839340800000）。 **取值范围：** 不涉及。 |
| domain | Object | **参数解释：** 工作项的领域 。 **取值范围：** 不涉及。 |
| developer | Object | **参数解释：** 工作项的开发人员。 **取值范围：** 不涉及。 |
| closeder | Object | **参数解释：** 关闭人员。 **取值范围：** 不涉及。 |
| position | String | **参数解释：** 工作项在列表的展示位置 。 **取值范围：** 不涉及。 |
| closed_flag | Integer | **参数解释：** 关闭标志 。 **取值范围：** 0（打开） 1（关闭） |
| assigned_cc_user | String | **参数解释：** 工作项的抄送人。 **取值范围：** 不涉及。 |
| custom_value_new | Object | **参数解释：** 自定义字段。 **取值范围：** 不涉及。 |
| status | [Status] object | **参数解释：** 工作项的状态。 **取值范围：** 不涉及。 |
表5StoryPoint
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| id | Integer | **参数解释：** 故事点id。 **取值范围：** 不涉及。 |
| name | String | **参数解释：** 故事点名称。 **取值范围：** 不涉及。 |
表6Project
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| identifier | String | **参数解释：** 项目uuid。 **取值范围：** 不涉及。 |
| name | String | **参数解释：** 项目名称。 **取值范围：** 不涉及。 |
| id | Integer | **参数解释：** 项目数字id。 **取值范围：** 不涉及。 |
| type | String | **参数解释：** 项目类型。 **取值范围：** scrum。 |
表7Tracker
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| name | String | **参数解释：** 类型名称。 **取值范围：** - Task。 - Bug。 - Epic。 - Feature。 - Story。 |
| id | Integer | **参数解释：** 类型id。 **取值范围：** 2（任务/Task） 3（缺陷/Bug） 5（Epic） 6（Feature） 7（Story） |
表8assigned_to
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| firstName | String | **参数解释：** 用户名。 **取值范围：** 不涉及。 |
| lastName | String | **参数解释：** 用户姓名。 **取值范围：** 不涉及。 |
| identifier | String | **参数解释：** 用户32位uuid。 **取值范围：** 不涉及。 |
| image_id | String | **参数解释：** 用户头像id。 **取值范围：** 不涉及。 |
| assignedNickName | String | **参数解释：** 用户昵称。 **取值范围：** 不涉及。 |
| name | String | **参数解释：** 用户名。 **取值范围：** 不涉及。 |
| id | Integer | **参数解释：** 用户数字id。 **取值范围：** 不涉及。 |
表9StatusAttributeVO
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| id | String | **参数解释：** 项目id。 **取值范围：** 不涉及。 |
| name | String | **参数解释：** 名称。 **取值范围：** 不涉及。 |
表10Severity
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| name | String | **参数解释：** 工作项的重要程度。 **取值范围：** - 关键 - 重要 - 一般 - 提示 |
| id | Integer | **参数解释：** 重要程度id。 **取值范围：** 10 （关键） 11 （重要） 12 （一般） 13 （提示） |
表11author
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| firstName | String | **参数解释：** 用户名称。 **取值范围：** 不涉及。 |
| lastName | String | **参数解释：** 用户姓名。 **取值范围：** 不涉及。 |
| identifier | String | **参数解释：** 作者唯一标识。 **取值范围：** 不涉及。 |
| image_id | String | **参数解释：** 用户头像id。 **取值范围：** 不涉及。 |
| authorNickName | String | **参数解释：** 用户昵称。 **取值范围：** 不涉及。 |
| name | String | **参数解释：** 带租户信息的用户名（租户名称_用户名）。 **取值范围：** 不涉及。 |
| id | Integer | **参数解释：** 用户id。 **取值范围：** 不涉及。 |
表12Priority
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| name | String | **参数解释：** 工作项的优先级。 **取值范围：** - 低。 - 中。 - 高。 |
| id | Integer | **参数解释：** 优先级id 。 **取值范围：** 1（低） 2（中） 3（高） |
表13Status
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| name | String | **参数解释：** 状态名称 **取值范围：** 新建 进行中 已解决 测试中 已关闭 已拒绝 |
| id | Integer | **参数解释：** 状态id。 **取值范围：** 1（新建） 2（进行中） 3（已解决） 4（测试中） 5（ 已关闭） 6（已拒绝） |
#### 请求示例
```
POST https://{endpoint}/v2/issues/create
{
"projectUUId" : "381fcca9c056482d92da3e8b9da71db5",
"tracker_id" : 6,
"priority_id" : 2,
"subject" : "凤凰商城",
"parent_issue_id" : 69782386,
"description" : " 作为 <用户角色>
我想要 <结果>
以便于 <目的>
",
"due_date" : 1752883200000,
"start_date" : 1752796800000,
"severity_id" : 12,
"done_ratio" : 0,
"status_id" : 1,
"expected_work_hours" : 0,
"plan_id" : "e674a60ba61546199e7c1207264b249b"
}
```
#### 响应示例
**状态码：200**
```
{
"result" : {
"issue" : {
"id" : 69913157,
"subject" : "凤凰商城",
"due_date" : "1752854400000",
"author" : {
"firstName" : "hw_008618814464665_01",
"lastName" : "hw19145027",
"identifier" : "073a9e23188025b31f06c0104a74c376",
"name" : "hw19145027",
"id" : 233087,
"authorNickName" : "asdf4"
},
"start_date" : "1752768000000",
"done_ratio" : 0,
"expected_work_hours" : 0,
"actual_work_hours" : 0,
"position" : "69913157",
"releaseDev" : "",
"closed_flag" : 0,
"deleted" : false,
"project" : {
"identifier" : "381fcca9c056482d92da3e8b9da71db5",
"name" : "DevOps全流程示例项目xxxx",
"id" : 13222601,
"type" : "scrum"
},
"tracker" : {
"name" : "Feature",
"id" : 6
},
"status" : {
"name" : "新建",
"id" : 1
},
"assigned_to" : {
"firstName" : "hw_008618814464665_01",
"lastName" : "hw19145027",
"identifier" : "073a9e23188025b31f06c0104a74c376",
"assignedNickName" : "asdf4",
"name" : "hw19145027",
"id" : 233087
},
"developer" : { },
"priority" : {
"name" : "中",
"id" : 2
},
"severity" : {
"name" : "一般",
"id" : 12
},
"module" : { },
"fixed_version" : { },
"assigned_cc_user" : [ ]
}
},
"status" : "success"
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | 思维导图中创建工作项接口成功的响应。 |
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。