细粒度权限用户创建工作项
功能介绍
拥有IAM细粒度权限（projectmanConfig:systemSettingField:set）且在devcloud项目中有创建工作项的权限的用户可以设置工作项的创建者
URI
POST /v4/projects/{project_id}/system/issue
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
devcloud项目的32位id |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 '可维护性' 19 '其他DFX' 20 '可用性' |
|
done_ratio |
否 |
Integer |
工作项进度值 |
|
end_time |
否 |
String |
结束时间，年-月-日 |
|
expected_work_hours |
否 |
Double |
预计工时 |
|
iteration_id |
否 |
Integer |
迭代id |
|
module_id |
否 |
Integer |
模块id |
|
name |
是 |
String |
标题 |
|
parent_issue_id |
否 |
Integer |
父工作项的id,创建子工作项时必填，父工作项的类型tracker_id不能为2,3 |
|
priority_id |
是 |
Integer |
优先级, 1 低, 2 中, 3 高, |
|
severity_id |
否 |
Integer |
重要程度, 10 关键, 11 重要, 12 一般, 13 提示, |
|
status_id |
否 |
Integer |
状态 id, 新建 1, 进行中 2, 已解决 3, 测试中 4, 已关闭 5, 已拒绝 6, |
|
tracker_id |
是 |
Integer |
工作项类型, 2任务/Task,3缺陷/Bug,5Epic,6Feature,7Story; 5 只能为 6 的父工作项类型; 6 只能为 7 的父工作项类型; 7 只能为 2,3的父; |
|
new_custom_fields |
否 |
Array of NewCustomField objects |
用户自定义字段 |
|
creator |
是 |
Creator object |
用户信息 |
|
custom_fields |
否 |
Array of ScrumCustomField objects |
用户自定义字段 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
actual_work_hours |
Double |
实际工时 |
|
assigned_cc_user |
Array of IssueUser objects |
抄送人 |
|
assigned_user |
IssueUser object |
用户信息 |
|
begin_time |
String |
开始时间，年-月-日 |
|
creator |
IssueUser object |
用户信息 |
|
custom_fields |
Array of CustomField objects |
自定义属性值,不建议使用，建议参考new_custom_fields字段 |
|
new_custom_fields |
Array of NewCustomField objects |
自定义属性值 |
|
developer |
IssueUser object |
用户信息 |
|
domain |
domain object |
id 领域, 14 '性能', 15 '功能', 16 '可靠性', 17 '网络安全', 18 '可维护性', 19 '其他DFX', 20 '可用性', |
|
done_ratio |
Integer |
工作项进度值 |
|
end_time |
String |
结束时间，年-月-日 |
|
expected_work_hours |
Double |
预计工时 |
|
id |
Integer |
工作项项id |
|
project |
IssueProjectResponseV4 object |
项目信息 |
|
iteration |
iteration object |
迭代 |
|
module |
module object |
模块 |
|
parent_issue |
parent_issue object |
父工作项 |
|
priority |
priority object |
工作项优先级 |
|
severity |
severity object |
工作项重要程度 |
|
status |
status object |
工作项状态 |
|
tracker |
tracker object |
工作项类型 2任务/Task,3缺陷/Bug,5Epic,6Feature,7Story |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
user_id |
String |
用户uuid |
|
user_num_id |
Integer |
用户数字id |
|
id |
Integer |
用户id |
|
name |
String |
带租户名的用户名(租户名_用户名) |
|
nick_name |
String |
昵称 |
|
first_name |
String |
用户名 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
custom_field |
String |
自定义字段 |
|
field_name |
String |
自定义字段名称 |
|
value |
String |
自定义属性对应的值，多个值以英文逗号区分开 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
project_id |
String |
项目id |
|
project_name |
String |
项目名称 |
|
project_num_id |
Integer |
项目数字id |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_msg |
String |
错误描述 |
|
error_code |
String |
错误码 |
状态码：401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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
{
"actual_work_hours" : 0,
"assigned_cc_user" : [ {
"id" : 4091,
"name" : "demo_user_name",
"nick_name" : "bear"
} ],
"assigned_user" : {
"id" : 4091,
"name" : "demo_user_name",
"nick_name" : "bear"
},
"begin_time" : "2020-09-12",
"creator" : {
"id" : 4091,
"name" : "demo_user_name",
"nick_name" : "bear"
},
"custom_fields" : [ {
"name" : "customField16",
"value" : "多选框",
"new_name" : "custom_field16"
} ],
"new_custom_fields" : [ {
"custom_field" : "custom_field16",
"field_name" : "field_name",
"value" : "多选框1,多选框2"
} ],
"developer" : {
"id" : 4091,
"name" : "demo_user_name",
"nick_name" : "bear1"
},
"domain" : {
"id" : 14,
"name" : "性能"
},
"done_ratio" : 0,
"end_time" : "2020-09-19",
"expected_work_hours" : 9,
"id" : 4567,
"project" : {
"project_id" : "526cefde62004de2b62b5e8dd2c2b3af",
"project_name" : "testDemo",
"project_num_id" : 78953
},
"iteration" : {
"id" : 456,
"name" : "迭代1"
},
"module" : {
"id" : 456,
"name" : "Project"
},
"parent_issue" : {
"id" : 123,
"name" : "parentIssue"
},
"priority" : {
"id" : 1,
"name" : "低"
},
"severity" : {
"id" : 12,
"name" : "一般"
},
"status" : {
"id" : 1,
"name" : "新建"
},
"tracker" : {
"id" : 7,
"name" : "story"
}
}状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
错误码
请参见错误码。
