# 复制工作项 - CopyIssue #### 功能介绍 复制工作项。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。 #### 授权信息 当前API调用无需身份策略权限。 #### URI POST /v2/workitem/duplication #### 请求参数 表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参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | copyComments | 否 | Boolean | **参数解释：** 是否复制评论数据。 **约束限制：** 不涉及。 **取值范围：** true：复制评论数据 false：不复制评论数据 **默认取值：** 不涉及。 | | copyWorkHours | 否 | Boolean | **参数解释：** 是否复制工时数据。 **约束限制：** 不涉及。 **取值范围：** true：复制工时数据 false：不复制工时数据 **默认取值：** 不涉及。 | | fromProjectUUId | 否 | String | **参数解释**： 原项目的32位uuid，项目唯一标识，通过[查询项目列表](https://support.huaweicloud.com/api-projectman/ListProjectsV4.html)接口获取，响应消息体中的**project_id**字段的值就是项目ID。 **约束限制**： 32位的数字和字母组成的字符串。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | issueIds | 否 | String | **参数解释：** 工作项id，可通过[高级查询工作项](https://support.huaweicloud.com/api-projectman/ListIssuesV4.html)接口获取，响应消息体中的**id**字段的值就是工作项id。 **约束限制：** 长度在1位到10位之间的纯数字。 **取值范围：** 最小长度：1，最大长度：10。 **默认取值：** 不涉及。 | | toProjectUUId | 否 | String | **参数解释**： 目标项目的32位uuid，项目唯一标识，通过[查询项目列表](https://support.huaweicloud.com/api-projectman/ListProjectsV4.html)接口获取，响应消息体中的**project_id**字段的值就是项目ID。 **约束限制**： 32位的数字和字母组成的字符串。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | result | [result] object | **参数解释：** 返回信息。 | | status | String | **参数解释：** 返回状态。 | 表4result | 参数 | 参数类型 | 描述 | |:---|:---|:---| | createIssues | Array of [IssueResponse] objects | **参数解释：** 创建的工作项数据。 | | errorIssues | Array of [IssueResponse] objects | **参数解释：** 创建失败的工作项。 | | successIssues | Array of [IssueResponse] objects | **参数解释：** 创建成功的工作项。 | 表5IssueResponse | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 工作项列表id。 **取值范围：** 不涉及。 | | tracker_id | Integer | **参数解释：** 工作项类型id。 **取值范围：** 2（任务/Task） 3（缺陷/Bug） 5（Epic） 6（Feature） 7（Story） | | project_id | Integer | **参数解释：** 项目数字id。 **取值范围：** 不涉及。 | | projectUUId | String | **参数解释：** 项目32位uuid。 **取值范围：** 不涉及。 | | subject | String | **参数解释：** 工作项的标题。 **取值范围：** 不涉及。 | | status_id | Integer | **参数解释：** 工作项状态id。 **取值范围：** 1（新建） 2（进行中） 3（已解决） 4（测试中） 5（已关闭） 6（已拒绝） | | assigned_to_id | Integer | **参数解释：** 工作项负责人数字id。 **取值范围：** 不涉及。 | | priority_id | Integer | **参数解释：** 工作项的优先级。 **取值范围：** 1（低） 2（中） 3（高） | | author | Integer | **参数解释：** 工作项负责人。 **取值范围：** 不涉及。 | | created_on | String | **参数解释：** 工作项的创建日期。时间格式（示例：2025-08-20 10:52:35） 。 **取值范围：** 不涉及。 | | updated_on | String | **参数解释：** 工作项的更新日期。时间戳格式（示例：1839340800000） 。 **取值范围：** 不涉及。 | | description | String | **参数解释：** 工作项描述。 **取值范围：** 不涉及。 | | severity_id | Integer | **参数解释：** 工作项的重要程度。 **取值范围：** 10 （关键） 11 （重要） 12 （一般） 13 （提示） | | story_point_id | Integer | **参数解释：** 工作项的故事点id。 **取值范围：** 不涉及。 | | closed_flag | Integer | **参数解释：** 关闭标志 。 **取值范围：** 0（打开） 1（关闭） | | is_archived | Boolean | **参数解释：** 是否归档。 **取值范围：** true（是） false（不是） | | expected_work_hours | Double | **参数解释：** 工作项的预计工时(单位：人时)。 **取值范围：** 不涉及。 | | actual_work_hours | Double | **参数解释：** 工作项的实际工时（单位：人/时）。 **取值范围：** 不涉及。 | #### 请求示例 ``` POST http://{endpoint}/v2/workitem/duplication { "fromProjectUUId" : "a6a33eca679b435b85574bd2fde46ce7", "issueIds" : 69901043, "toProjectUUId" : "a8ac165097ff4e42bcfb234dd27d30a6", "copyComments" : false, "copyWorkHours" : false } ``` #### 响应示例 **状态码：200** ``` { "result" : { "successIssues" : [ { "id" : 69901043, "tracker_id" : 7, "project_id" : 13281266, "projectUUId" : "a6a33eca679b435b85574bd2fde46ce7", "subject" : "1233443", "status_id" : 1, "assigned_to_id" : 1274137, "priority_id" : 2, "author" : 1274137, "created_on" : "2025-08-18 23:36:51", "updated_on" : "1755531417000", "description" : "TEST", "severity_id" : 12, "expected_work_hours" : 0, "actual_work_hours" : 0, "story_point_id" : 3, "closed_flag" : 0, "is_archived" : false } ], "createIssues" : [ { "id" : 69913248, "tracker_id" : 7, "project_id" : 13281266, "projectUUId" : "a6a33eca679b435b85574bd2fde46ce7", "subject" : "1233443", "status_id" : 1, "assigned_to_id" : 1274137, "priority_id" : 2, "author" : 1274137, "created_on" : "2025-08-18 23:36:51", "updated_on" : "1755531417000", "description" : "TEST", "severity_id" : 12, "expected_work_hours" : 0, "actual_work_hours" : 0, "story_point_id" : 3, "closed_flag" : 0 } ], "errorIssues" : [ ] }, "status" : "success" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 复制工作项接口成功的响应。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。