更新时间：2026-09-01 GMT+08:00

创建特性集，预留批量接口，当前仅支持单条数据创建 - CreateFeatureSetApi

功能介绍

创建特性集，预留批量接口，当前仅支持单条数据创建。

调用方法

请参见如何调用API。

授权信息

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

URI

POST /v1/ipdprojectservice/projects/{project_id}/feature-sets

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目32位ID，项目唯一标识。通过查询IPD项目列表获取，响应消息体中的id字段的值就是项目ID。约束限制：不涉及。取值范围： 32个字符，由英文字母和数字组成。默认取值：不涉及。

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
title	是	String	参数解释：特性集标题。约束限制：不涉及。取值范围： 2~256个字符。默认取值：不涉及。
parent_id	是	String	参数解释：父特性集ID。可以通过查询特性集接口获取，响应消息体中的id字段的值就是特性集ID。约束限制： 18~19个字符的数字字符串。根特性集的parent_id为空字符串或"0"。取值范围：不涉及。默认取值：不涉及。

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
status	String	参数解释：返回状态。取值范围： success：响应成功。 error：响应失败
message	String	错误信息
result	FeatureSetOperateParam object	特性集创建、修改请求参数对象

表4 FeatureSetOperateParam
参数	参数类型	描述
id	String	参数解释：特性集ID。创建时由系统自动生成，更新时必填。取值范围：不涉及。
title	String	参数解释：特性集标题。取值范围： 2~256个字符。
position_float	Float	参数解释：特性集在目录树中的相对位置，从0开始的浮点数，不支持科学计数法。用于控制特性集的排序。取值范围：大于等于0，小于999999999999。
parent_id	String	参数解释：父特性集ID。可以通过查询特性集接口获取，响应消息体中的id字段的值就是特性集ID。取值范围：不涉及。

状态码：400

表5 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：不涉及。
error_msg	String	参数解释：错误描述，对error_code的补充解释。取值范围：不涉及。

请求示例

POST https://{endpoint}/v1/ipdprojectservice/projects/7102a33f44db4dacab136e1f6890ef86/feature-sets

{
  "title" : "这是一个222下面的特性集",
  "parent_id" : "981924601614213120"
}

响应示例

状态码：200

操作成功的响应

{
  "status" : "success",
  "message" : null,
  "result" : {
    "title" : "111c",
    "position_float" : 3,
    "parent_id" : "981957734821834752"
  }
}

状态码：400

请求失败的响应。例如无操作权限、项目不存在。

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

状态码

状态码	描述
200	操作成功的响应
400	请求失败的响应。例如无操作权限、项目不存在。

错误码

请参见错误码。

父主题： IPD特性/特性集管理