给自定义状态配置工作项类型
功能介绍
给自定义状态配置工作项类型。
调用方法
请参见如何调用API。
URI
POST /v2/issue-status/batch-tracker-config
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 必传。 取值范围: 最小长度:10,最大长度:32768。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
projectUUId |
否 |
String |
参数解释: 项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。 约束限制: 由字母和数字组成的32位字符串。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
trackerId |
否 |
String |
参数解释: 工作项类型id。 约束限制: 2,3,5,6,7。 取值范围: 2(任务/Task) 3(缺陷/Bug) 5(Epic) 6(Feature) 7(Story) 默认取值: 不涉及。 |
|
ids |
否 |
Array of strings |
参数解释: 自定义状态的id数组,可通过添加系统自定义状态接口获取,响应体中的result字段中的id就是自定义状态的id。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
result |
result object |
参数解释: 返回结果。 |
|
status |
String |
参数解释: 返回结果。 取值范围: success: 返回成功。 error: 返回失败。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
definedName |
String |
参数解释: 自定义状态名称。 取值范围: 不涉及。 |
|
description |
String |
参数解释: 自定义状态的描述。 取值范围: 不涉及。 |
|
flag |
Integer |
参数解释: 状态是否为自定义状态。 取值范围: 0(不是自定义状态) 1(是自定义状态) |
|
id |
String |
参数解释: 自定义状态id。 取值范围: 不涉及。 |
|
is_closed |
Boolean |
参数解释: 自定义状态是否为结束态。 取值范围: true(是结束态) false(不是结束态) |
|
is_initial |
Boolean |
参数解释: 自定义状态是否初始化。 取值范围: true(是初始化) false(不是初始化) |
|
position |
Integer |
参数解释: 自定义状态在页面中的位置。 取值范围: 不涉及。 |
|
statusAttribute |
Integer |
参数解释: 自定义状态类型。 取值范围: 不涉及。 |
|
issueStatusAttribute |
IssueStatusAttributeV1 object |
参数解释: 工作项状态属性。 |
|
statusAttributeName |
String |
参数解释: 自定义状态属性名称。 取值范围: 开始态 进行态 结束态 |
|
statusId |
Integer |
参数解释: 自定义状态数字id。 取值范围: 不涉及。 |
|
trackerId |
Integer |
参数解释: 工作项类型。 取值范围: 2(任务/Task) 3(缺陷/Bug) 5(Epic) 6(Feature) 7(Story) |
|
trackerList |
Array of integers |
参数解释: 工作项类型即trackerId的集合。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释: 项目32位UUID,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。 取值范围: 不涉及。 |
|
name |
String |
参数解释: 状态名称。 取值范围: 不涉及。 |
|
type |
String |
参数解释: 状态类型。 取值范围: 开始态 进行态 结束态 |
请求示例
POST http://{endpoint}/v2/issue-status/batch-tracker-config
{
"projectUUId" : "d2fc487f5a944d5e88bfbceedb7d6a86",
"trackerId" : "6",
"ids" : [ "c874570a75304e0aa2ff1172ae30ea4a" ]
}
响应示例
状态码:200
BatchCreateTrackerConfig接口成功的响应。
{
"result" : {
"issueStatusConfigs" : [ {
"id" : "298963741dbb40eb8a186575b5ab00bb",
"statusId" : 15,
"definedName" : "test1",
"position" : 15,
"flag" : 1,
"description" : "描述示例。",
"statusAttribute" : 35099694,
"statusAttributeName" : "结束态"
} ]
},
"status" : "success"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
BatchCreateTrackerConfig接口成功的响应。 |
错误码
请参见错误码。