更新标签
功能介绍
更新标签,支持更新标题和颜色。
调用方法
请参见如何调用API。
URI
PUT /v1/ipdprojectservice/projects/{project_id}/tags/{label_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
label_id |
是 |
String |
标签Id |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
label_type |
是 |
String |
标签归属的工作项分类,不传该参数时默认查询所有类型下的标签。作为更新参数时无效。 feature:特性 raw requirement:原始需求 requirement:研发需求 task:任务 bug:缺陷 |
|
color |
是 |
String |
标签颜色,作为更新参数时非必填。可选颜色代码:"#86CAFF", "#6DDEBB", "#A6DD82", "#FAC20A", "#FA9841", "#F66F6A", "#F3689A", "#A97AF8", "#71757F", "#5E7CE0", "#207AB3", "#169E6C", "#6CA83B", "#B58200", "#B54E04", "#B02121", "#AD215B", "#572DB3", "#4F4F4F", "#3C51A6" |
|
title |
是 |
String |
标签标题,最长支持15个字符。作为更新参数时非必填 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
status |
String |
参数解释: 返回状态。 取值范围: success:响应成功 error:响应失败 |
|
message |
String |
响应信息 |
|
result |
LabelEntity object |
标签详情 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释: 标签id,可通过查询标签列表接口获取,响应消息体中的id字段的值就是标签id。 约束限制: 正则表达式,^([0-9]{18,19})$。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
label_type |
String |
参数解释: 标签所属工作项类型,对应工作项的type字段,枚举类型。 约束限制: 不涉及。 取值范围: raw requirement:原始需求 feature:系统特性 requirement:研发需求 task:任务 bug:缺陷 默认取值: 不涉及。 |
|
color |
String |
参数解释: 标签颜色RGB。 约束限制: 最小长度:0,最大长度:16。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
title |
String |
参数解释: 标签标题。 约束限制: 最小长度:2,最大长度:256。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求示例
更新标签标题
https://{endpoint}/v1/ipdprojectservice/projects/b54914d464d1498a97d683ef198ec448/tags/1030868827803529217
{
"label_type" : "requirement",
"color" : "#86CAFF",
"title" : "New Label Title"
}
响应示例
状态码:200
OK
{
"status" : "success",
"message" : "ok",
"result" : {
"title" : "Tag-IR-02111221"
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
错误码
请参见错误码。