# 更新工作项 - UpdateIssue #### 功能介绍 更新工作项。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。 #### 授权信息 当前API调用无需身份策略权限。 #### URI POST /v3/issues/update #### 请求参数 表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参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | id | 是 | String | **参数解释：** 工作项id，可通过[高级查询工作项](https://support.huaweicloud.com/api-projectman/ListIssuesV4.html)接口获取，响应消息体中的**id**字段的值就是工作项id。 **约束限制：** 长度在1位到10位之间的纯数字。 **取值范围：** 最小长度：1，最大长度：10。 **默认取值：** 不涉及。 | | due_date | 否 | String | 参数解释： 当前迭代的截止日期（时间戳格式，示例：1839340800000）。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 | | project_id | 是 | String | **参数解释**： 项目的32位uuid，项目唯一标识，通过[查询项目列表](https://support.huaweicloud.com/api-projectman/ListProjectsV4.html)接口获取，响应消息体中的**project_id**字段的值就是项目ID。 **约束限制**： 由数字和英文组成的32字符串。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | type | 否 | String | **参数解释**： 工作项所属项目类型。 **约束限制**： 不涉及。 **取值范围**： scrum。 **默认取值**： 不涉及。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | - | String | **参数解释：** 更新工作项接口的响应结果。 | | result | [result] object | **参数解释：** 返回结果。 **取值范围：** 不涉及。 | | status | String | **参数解释：** 返回状态。 **取值范围：** success：返回成功。 error：返回失败。 | 表4result | 参数 | 参数类型 | 描述 | |:---|:---|:---| | issue | [issue] object | **参数解释：** 工作项详情。 **取值范围：** 不涉及。 | 表5issue | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 项目ID。 **取值范围：** 不涉及。 | | projectUUId | String | **参数解释：** 项目32位UUID。 **取值范围：** 不涉及。 | | subject | String | **参数解释：** 工作项的标题。 **取值范围：** 不涉及。 | | due_date | String | **参数解释：** 工作项的截止时间。时间戳格式（示例：1839340800000）。 **取值范围：** 不涉及。 | | order | [Order] object | **参数解释：** 排序信息。 **取值范围：** 不涉及。 | | author | [AuthorVO] object | **参数解释：** 用户信息。 **取值范围：** 不涉及。 | | lockVersion | Integer | **参数解释：** 锁版本。 **取值范围：** 不涉及。 | | created_on | String | **参数解释：** 工作项的创建时间。时间戳格式（示例：1839340800000）。 **取值范围：** 不涉及。 | | updated_on | String | **参数解释：** 工作项的更新日期。时间戳格式（示例：1839340800000） 。 **取值范围：** 不涉及。 | | start_date | String | **参数解释：** 工作项的开始日期 。时间戳格式（示例：1839340800000）。 **取值范围：** 不涉及。 | | done_ratio | Integer | **参数解释：** 工作项完成度。 **取值范围：** 不涉及。 | | root_id | Integer | **参数解释：** 根工作项的id。 **取值范围：** 不涉及。 | | is_private | Boolean | **参数解释：** 工作项是否私有。 **取值范围：** true（私有）。 false（非私有）。 | | description | String | **参数解释：** 工作项的描述。 **取值范围：** 不涉及。 | | expected_work_hours | Integer | **参数解释：** 工作项的预计工时（单位：人/时）。 **取值范围：** 不涉及。 | | actual_work_hours | Integer | **参数解释：** 工作项的实际工时（单位：人/时）。 **取值范围：** 不涉及。 | | statusName | String | **参数解释：** 工作项的状态名称（示例：新建）。 **取值范围：** 不涉及。 | | newStatusName | String | *参数解释：*\* 工作项的新状态名称（示例：新建）。 **取值范围：** 不涉及。 | | position | String | **参数解释：** 状态在页面的位置ID。 **取值范围：** 不涉及。 | | assigned_cc | String | **参数解释：** 分配的抄送人。 **取值范围：** 不涉及。 | | releaseDev | String | **参数解释：** 工作项发布版本号。 **取值范围：** 不涉及。 | | developer | [developerVO] object | **参数解释：** 工作项开发者。 **取值范围：** 不涉及。 | | closed_flag | Integer | **参数解释：** 关闭标志。 **取值范围：** 0（打开） 1（关闭） | | deleted | Boolean | **参数解释：** 是否删除。 **取值范围：** true（删除） false（不删除） | | is_archived | Boolean | **参数解释：** 归档状态。 **取值范围：** true（已归档）。 false（未归档）。 | | status_attribute | [StatusAttributeVO] object | **参数解释：** 工作项的状态属性。 **取值范围：** 不涉及。 | | customValueNew | Object | **参数解释：** 自定义字段。 **取值范围：** 不涉及。 | | is_watcher | Boolean | **参数解释：** 是否关注。 **取值范围：** true（关注） false（不关注） | | children | Array of strings | **参数解释：** 子工作项。 **取值范围：** 不涉及。 | | project | [Project] object | **参数解释：** 项目信息。 **取值范围：** 不涉及。 | | tracker | [Tracker] object | **参数解释：** 工作项类型。 **取值范围：** 不涉及。 | | status | [Status] object | **参数解释：** 工作项状态。 **取值范围：** 不涉及。 | | assigned_to | [IssueAssignedTo] object | **参数解释：** 工作项分配责任人。 **取值范围：** 不涉及。 | | priority | [Priority] object | **参数解释：** 工作项优先级。 **取值范围：** 不涉及。 | | severity | [Severity] object | **参数解释：** 工作项重要程度。 **取值范围：** 不涉及。 | | domain | [Domain] object | **参数解释：** 工作项领域。 **取值范围：** 不涉及。 | | module | [ModulesVO] object | **参数解释：** 工作项模块。 **取值范围：** 不涉及。 | | fixed_version | [FixedVersion] object | **参数解释：** 工作项修复版本。 **取值范围：** 不涉及。 | | story_point | [story_point] object | **参数解释：** 工作项故事点。 **取值范围：** 不涉及。 | | assigned_cc_user | Array of [AssignedCcUser] objects | **参数解释：** 工作项的抄送人。 **取值范围：** 不涉及。 | 表6Order | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | Integer | **参数解释：** 排序名称。 **取值范围：** 不涉及。 | | id | Integer | **参数解释：** 排序id。 **取值范围：** 不涉及。 | 表7AuthorVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | firstName | String | **参数解释：** 用户名称。 **取值范围：** 不涉及。 | | lastName | String | **参数解释：** 用户姓名。 **取值范围：** 不涉及。 | | identifier | String | **参数解释：** 作者唯一标识。 **取值范围：** 不涉及。 | | imageId | String | **参数解释：** 用户头像id。 **取值范围：** 不涉及。 | | assignedNickName | String | **参数解释：** 用户昵称。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 带租户信息的用户名（租户名称_用户名）。 **取值范围：** 不涉及。 | | id | Integer | **参数解释：** 用户id。 **取值范围：** 不涉及。 | 表8developerVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | firstName | String | **参数解释：** 开发者名称。 **取值范围：** 不涉及。 | | lastName | String | **参数解释：** 开发者姓名。 **取值范围：** 不涉及。 | | identifier | String | **参数解释：** 开发者唯一标识。 **取值范围：** 不涉及。 | | imageId | String | **参数解释：** 开发者头像id。 **取值范围：** 不涉及。 | | assignedNickName | String | **参数解释：** 开发者昵称。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 带租户信息的用户名（租户名称_用户名）。 **取值范围：** 不涉及。 | | id | Integer | **参数解释：** 开发者id。 **取值范围：** 不涉及。 | 表9StatusAttributeVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 项目id。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 名称。 **取值范围：** 不涉及。 | 表10Project | 参数 | 参数类型 | 描述 | |:---|:---|:---| | identifier | String | **参数解释：** 项目uuid。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 项目名称。 **取值范围：** 不涉及。 | | id | Integer | **参数解释：** 项目数字id。 **取值范围：** 不涉及。 | | type | String | **参数解释：** 项目类型。 **取值范围：** scrum。 | 表11Tracker | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 类型名称。 **取值范围：** - Task。 - Bug。 - Epic。 - Feature。 - Story。 | | id | Integer | **参数解释：** 类型id。 **取值范围：** 2（任务/Task） 3（缺陷/Bug） 5（Epic） 6（Feature） 7（Story） | 表12Status | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 状态名称 **取值范围：** 新建 进行中 已解决 测试中 已关闭 已拒绝 | | id | Integer | **参数解释：** 状态id。 **取值范围：** 1（新建） 2（进行中） 3（已解决） 4（测试中） 5（ 已关闭） 6（已拒绝） | 表13IssueAssignedTo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | firstName | String | **参数解释：** 用户名。 **取值范围：** 不涉及。 | | lastName | String | **参数解释：** 用户姓名。 **取值范围：** 不涉及。 | | identifier | String | **参数解释：** 用户32位uuid。 **取值范围：** 不涉及。 | | imageId | String | **参数解释：** 用户头像id。 **取值范围：** 不涉及。 | | assignedNickName | String | **参数解释：** 用户昵称。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 用户名。 **取值范围：** 不涉及。 | | id | Integer | **参数解释：** 用户数字id。 **取值范围：** 不涉及。 | 表14Priority | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 工作项的优先级。 **取值范围：** - 低。 - 中。 - 高。 | | id | Integer | **参数解释：** 优先级id 。 **取值范围：** 1（低） 2（中） 3（高） | 表15Severity | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 工作项的重要程度。 **取值范围：** - 关键 - 重要 - 一般 - 提示 | | id | Integer | **参数解释：** 重要程度id。 **取值范围：** 10 （关键） 11 （重要） 12 （一般） 13 （提示） | 表16Domain | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 领域名称。 **取值范围：** 不涉及。 | | id | Integer | **参数解释：** 领域id。 **取值范围：** 不涉及。 | 表17ModulesVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | path | String | **参数解释：** 模块的路径。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 模块的名称。 **取值范围：** 不涉及。 | | id | Integer | **参数解释：** 模块的id。 **取值范围：** 不涉及。 | | path_name | String | **参数解释：** 模块路径的名称。 **取值范围：** 不涉及。 | 表18FixedVersion | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 修复版本名称。 **取值范围：** 不涉及。 | | id | Integer | **参数解释：** 修复版本id。 **取值范围：** 不涉及。 | 表19story_point | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 工作项的故事点id。 **取值范围：** 1（0） 2（1/2） 3（1） 4（2） 5（3） 6（5） 7（8） 8（13） 9（21） 10（40） 11（80） 12（100） | | name | String | **参数解释：** 工作项的故事点名称。 | 表20AssignedCcUser | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释：** 用户id。 **取值范围：** 不涉及。 | | login | String | **参数解释：** 用户登录名。 **取值范围：** 不涉及。 | | firstname | String | **参数解释：** 用户名。 **取值范围：** 不涉及。 | | lastname | String | **参数解释：** 用户姓。 **取值范围：** 不涉及。 | | userName | String | **参数解释：** 用户姓名。 **取值范围：** 不涉及。 | | admin | Integer | **参数解释：** 管理员。 **取值范围：** 不涉及。 | | status | Integer | **参数解释：** 状态属性。 **取值范围：** 0（开始态）。 1（进行态）。 2（结束态）。 | | createdOn | String | **参数解释：** 创建时间。 **取值范围：** 不涉及。 | | domainId | String | **参数解释：** 租户uuid。 **取值范围：** 不涉及。 | | domainName | String | **参数解释：** 租户名。 **取值范围：** 不涉及。 | | identifier | String | **参数解释：** 用户32位uuid。 **取值范围：** 不涉及。 | | nickName | String | **参数解释：** 用户昵称。 **取值范围：** 不涉及。 | #### 请求示例 ``` POST http:/{endpoint}/ProjectManAdapter/v3/issues/update?_=1753364837888 { "id": 0000000, "project_id": "xxxxxxxxxxxxxx", "due_date": "1753718400000", "type": "scrum" } ``` #### 响应示例 **状态码：200** ``` { "result": { "issue": { "id": "0000000", "projectUUId": "xxxxxxxxxxxxxx", "subject": "00000", "due_date": "1752595200000", "order": { "name": 1, "id": 1 }, "author": { "firstName": "xxxxxx", "lastName": "xxxxxx", "identifier": "xxxxxxxxxxxxxx", "imageId": "photo.png", "name": "xxxxxxx", "id": 0000 }, "lockVersion": 0, "created_on": "1754914530000", "updated_on": "1755221661000", "start_date": "1751385600000", "done_ratio": 0, "root_id": 0000000, "is_private": false, "description": "test", "expected_work_hours": 5, "actual_work_hours": 0, "statusName": "新建", "newStatusName": "新建", "position": "9213096.0000000000", "assigned_cc": "00000000000000000", "releaseDev": "", "developer": { "firstName": "xxxxxx", "lastName": "xxxxxx", "identifier": "00000000000000000", "imageId": "photo.png", "assignedNickName": "xxxxxx", "name": "xxxxxx", "id": 0000 }, "closed_flag": 0, "deleted": false, "is_archived": false, "status_attribute": { "name": "开始态", "id": 34746202 }, "customValueNew": {}, "is_watcher": false, "children": [], "project": { "identifier": "00000000000000000", "name": "Scrum-1", "id": 00000000, "type": "scrum" }, "tracker": { "name": "Story", "id": 7 }, "status": { "name": "新建", "id": 1 }, "assigned_to": { "firstName": "xxxxxxx", "lastName": "xxxxxxx", "identifier": "00000000000000000", "imageId": "photo.png", "assignedNickName": "xxxxx", "name": "xxxxxxx", "id": 0000 }, "priority": { "name": "中", "id": 2 }, "severity": { "name": "一般", "id": 12 }, "domain": { "name": "功能", "id": 15 }, "module": { "path": "00000000", "name": "00000000", "id": 00000000, "path_name": "000000000" }, "fixed_version": { "name": "xxxx", "id": 26660216 }, "story_point": { "id": 3, "name": "1" }, "assigned_cc_user": [ { "id": 0000, "login": "xxxxxxxxxxxx", "firstname": "xxxxxxxxxxxx", "lastname": "xxxxxxxxxxxx", "userName": "xxxxxxxxxxxx", "admin": 0, "status": 1, "createdOn": "1599104374000", "domainId": "xxxxxxxxxxxx", "domainName": "xxxxxxxxxxxx", "identifier": "xxxxxxxxxxxx", "nickName": "xxxxxxxxxxxx" } ] } }, "status": "success" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 更新工作项接口成功的响应。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。