4.1 Scrum 项目的工作项
4.1.15 细粒度权限用户创建工作项
功能介绍
拥有IAM细粒度权限(projectmanConfig:systemSettingField:set)且在devcloud项目 中有创建工作项的权限的用户可以设置工作项的创建者
调试
您可以在API Explorer中调试该接口。
URI
POST /v4/projects/{project_id}/system/issue
表4-146 路径参数
参数 是否必选 参数类型 描述
project_id 是 String devcloud的项目id 最小长度:32 最大长度:32
正则匹配:^[0-9a-z]{32}$
请求参数
表4-147 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。 通过调用IAM服务 获取用户Token接口获取(响应 消息头中X-Subject-Token的 值)。
最小长度:10 最大长度:32768
表4-148 请求 Body 参数
参数 是否必选 参数类型 描述
actual_work_
hours 否 Double 实际工时
assigned_id 否 Integer 处理人id,对应用户信息的数字id begin_time 否 String 开始时间,年-月-日
description 否 String 描述信息
developer_id 否 Integer 开发者id,对应用户信息的数字id domain_id 否 Integer id 领域, 14 '性能', 15 '功能', 16
'可靠性' 17 '网络安全' 18 '可维
参数 是否必选 参数类型 描述
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; 5 只 能为 6 的父工作项类型; 6 只能 为 7 的父工作项类型; 7 只能为 2,3的父;
creator 是 Creator
object custom_fields 否 Array of
ScrumCusto mField objects
用户自定义字段
表4-149 Creator
参数 是否必选 参数类型 描述
user_id 是 String 指定工作项的创建者用户id
表4-150 ScrumCustomField
参数 是否必选 参数类型 描述
name 否 String 自定义字段
参数 是否必选 参数类型 描述
hours Double 实际工时
assigned_cc_u
ser Array of IssueUser objects
抄送人
assigned_user IssueUser object
begin_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
object 迭代
module module 模块
参数 参数类型 描述 parent_issue parent_issue
object 父工作项 priority priority
object 工作项优先级 severity severity
object 工作项重要程度 status status object 工作项状态 tracker tracker object 工作项类型
表4-152 IssueUser
参数 参数类型 描述
id Integer 用户id
name String 用户名
nick_name String 昵称
表4-153 CustomField
参数 参数类型 描述
name String 自定义属性名
value String 自定义属性对应的值
表4-154 domain
参数 参数类型 描述
id Integer 领域id
name String 领域
表4-155 IssueProjectResponseV4
参数 参数类型 描述
project_id String 项目id project_name String 项目名称
参数 参数类型 描述 project_num_i
d Integer 项目数字id
表4-156 iteration
参数 参数类型 描述
id Integer 迭代id
name String 迭代名
表4-157 module
参数 参数类型 描述
id Integer 模块id
name String 模块
表4-158 parent_issue
参数 参数类型 描述
id Integer 父工作项id
name String 父工作项
表4-159 priority
参数 参数类型 描述
id Integer 优先级id
name String 优先级
表4-160 severity
参数 参数类型 描述
id Integer 重要程度id
name String 重要程度
表4-161 status
参数 参数类型 描述
id Integer 状态id
name String 状态名称
表4-162 tracker
参数 参数类型 描述
id Integer 类型id
name String 类型名称
状态码: 400
表4-163 响应 Body 参数
参数 参数类型 描述
error_msg String 错误描述 error_code String 错误码
状态码: 401
表4-164 响应 Body 参数
参数 参数类型 描述
error_msg String 错误描述 error_code String 错误码
请求示例
POST https://{endpoint}/v4/projects/526cefde62004de2b62b5e8dd2c2b3af/system/issue { "parent_issue_id" : 1679822,
"end_time" : "2018-07-05", "name" : "test",
"begin_time" : "2018-1-31", "description" : "",
"assigned_id" : 4091, "developer_id" : 4091, "tracker_id" : 3, "status_id" : 1, "priority_id" : 2,
"severity_id" : 10, "iteration_id" : 11302238, "creator" : {
"user_id" : "a360371833bf4c558f796fd707b44daf"
}}
响应示例
无
状态码
状态码 描述
200 OK
400 Bad Request 401 Unauthorized
错误码
请参见错误码。