文档首页/需求管理 CodeArts Req/API参考/API/IPD特性/特性集管理/编辑特性集 - UpdateFeatureSetApi
更新时间：2026-02-13 GMT+08:00
在线调试
CLI示例
查看PDF
分享

编辑特性集 - UpdateFeatureSetApi

功能介绍

支持修改标题、父特性集、相对位置信息。

调用方法

请参见如何调用API。

授权信息

当前API调用无需身份策略权限。

URI

PUT /v1/ipdprojectservice/projects/{project_id}/feature-sets/{feature_set_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

feature_set_id

是

String

特性集Id

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

title

否

String

特性集标题

position_float

否

Float

特性集在目录树中的相对位置，从0F开始的浮点数，不支持科学计数法

parent_id

是

String

父特性集Id,必填参数。

更新时需要移动特性集目录传入目标特性集Id，仅修改位置、标题属性时需要传入原父Id

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

status

String

参数解释：

返回状态。

取值范围：

success：响应成功

error：响应失败

message

String

错误信息

result

FeatureSetOperateParam object

特性集创建、修改参数

表4 FeatureSetOperateParam

参数

参数类型

描述

id

String

特性集Id

title

String

特性集标题

position_float

Float

特性集在目录树中的相对位置，从0F开始的浮点数，不支持科学计数法

parent_id

String

父特性集Id,必填参数。

更新时需要移动特性集目录传入目标特性集Id，仅修改位置、标题属性时需要传入原父Id

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误描述，对error_code的补充解释。

取值范围：

不涉及。

请求示例

PUT https://{endpoint}/v1/ipdprojectservice/projects/{project_id}/feature-sets/{feature_set_id}

{
  "title" : "这是一个2层的特性集3",
  "position_float" : 1,
  "parent_id" : "981924129047359488"
}

响应示例

状态码：200

成功响应

{
  "status" : "success",
  "message" : null,
  "result" : {
    "title" : "这是一个2层的特性集3",
    "parent_id" : "981924129047359488"
  }
}

状态码：400

通用错误响应

{
  "error_code" : "PM.02174103",
  "error_msg" : "无操作权限"
}

状态码

状态码

描述

200

成功响应

400

通用错误响应

错误码

请参见错误码。

相关文档