4.1 Scrum 项目的工作项
4.1.12 更新工作项
功能介绍
更新工作项
调试
您可以在API Explorer中调试该接口。
URI
PUT /v4/projects/{project_id}/issues/{issue_id}
表4-108 路径参数
参数 是否必选 参数类型 描述
project_id 是 String devcloud的项目id 最小长度:32 最大长度:32
正则匹配:^[0-9a-z]{32}$
issue_id 是 Integer 工作项id
请求参数
表4-109 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。 通过调用IAM服务 获取用户Token接口获取(响应
assigned_id 否 Integer 处理人id,对应用户信息的数字id begin_time 否 String 开始时间,年-月-日
description 否 String 描述信息
developer_id 否 Integer 开发者id,对应用户信息的数字id
domain_id 否 Integer 领域id
done_ratio 否 Integer 工作项进度值
end_time 否 String 结束时间,年-月-日
expected_wor
k_hours 否 Double 预计工时
iteration_id 否 Integer 迭代id
module_id 否 Integer 模块id
name 否 String 标题
参数 是否必选 参数类型 描述
tracker_id 否 Integer 工作项类型,2任务/task,3缺陷/
bug,5epic,6feature,7story
hours Double 实际工时
assigned_cc_u
ser Array of IssueUser objects
抄送人
assigned_user IssueUser object
begin_time String 预计开始时间,年-月-日 created_time String 创建时间 年-月-日 时:分:秒 creator IssueUser
object custom_fields Array of
CustomField objects
自定义属性值
developer IssueUser object domain domain
object id, 领域 14, '性能', 15, '功能', 16, '可靠性' 17, '网 络安全' 18, '可维护性' 19, '其他DFX' 20, '可用性' done_ratio Integer 工作项进度值
end_time String 预计结束时间,年-月-日 expected_wor
k_hours Double 预计工时
id Integer 工作项项id
project IssueProjectR esponseV4 object
项目信息
iteration iteration 迭代
参数 参数类型 描述 module module
object 模块
name String 标题
parent_issue parent_issue
object 父工作项 priority priority
object 工作项优先级 severity severity
object 工作项重要程度 status status object 工作项状态 tracker tracker object 工作项类型
updated_time String 更新时间 年-月-日 时:分:秒 closed_time String 关闭时间 年-月-日 时:分:秒
表4-112 IssueUser
参数 参数类型 描述
id Integer 用户id
name String 用户名
nick_name String 昵称
表4-113 CustomField
参数 参数类型 描述
name String 自定义属性名
value String 自定义属性对应的值
表4-114 domain
参数 参数类型 描述
id Integer 领域id
name String 领域
表4-115 IssueProjectResponseV4
参数 参数类型 描述
project_id String 项目id project_name String 项目名称 project_num_i
d Integer 项目数字id
表4-116 iteration
参数 参数类型 描述
id Integer 迭代id
name String 迭代名
表4-117 module
参数 参数类型 描述
id Integer 模块id
name String 模块
表4-118 parent_issue
参数 参数类型 描述
id Integer 父工作项id
name String 父工作项
表4-119 priority
参数 参数类型 描述
id Integer 优先级id
name String 优先级
表4-120 severity
参数 参数类型 描述
id Integer 重要程度id
name String 重要程度
表4-121 status
参数 参数类型 描述
id Integer 状态id
name String 状态名称
表4-122 tracker
参数 参数类型 描述
id Integer 类型id
name String 类型名称
状态码: 400
表4-123 响应 Body 参数
参数 参数类型 描述
error_msg String 错误描述 error_code String 错误码
状态码: 401
表4-124 响应 Body 参数
参数 参数类型 描述
error_msg String 错误描述 error_code String 错误码
请求示例
PUT https://{endpoint}/v4/projects/526cefde62004de2b62b5e8dd2c2b3af/issues/4568921
{ "status_id" : 2 }
响应示例
无
状态码
状态码 描述
200 OK
400 Bad Request 401 Unauthorized
错误码
请参见错误码。