文档首页/需求管理 CodeArts Req/API参考/API/IPD标签管理/删除标签 - DeleteIpdLabel
更新时间：2026-02-13 GMT+08:00
在线调试
CLI示例
查看PDF
分享

删除标签 - DeleteIpdLabel

功能介绍

删除标签

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

codeartsreq:tag:delete

Write

-

  • codeartsreq:Model

  • codeartsreq:ProjectId

-

-

URI

DELETE /v1/ipdprojectservice/projects/{project_id}/tags/{label_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目的32位uuid，项目唯一标识，通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

label_id

是

String

标签Id

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

status

String

参数解释：

返回状态。

取值范围：

  • success：响应成功

  • error：响应失败

message

String

响应信息

result

LabelEntity object

标签详情

表3 LabelEntity

参数

参数类型

描述

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

响应示例

状态码：200

OK

{
  "status" : "success",
  "message" : "ok",
  "result" : {
    "id" : "1030868827803529217"
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题：IPD标签管理

相关文档