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

更新模块 - UpdateIpdModule

功能介绍

更新指定模块信息,支持更新模块名称、父模块、描述和责任人。

调用方法

请参见如何调用API

授权信息

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

URI

PUT /v1/ipdprojectservice/projects/{project_id}/modules/{module_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目32位ID,项目唯一标识。通过查询IPD项目列表获取,响应消息体中的id字段的值就是项目ID。

约束限制

不涉及。

取值范围

32个字符,由英文字母和数字组成。

默认取值

不涉及。

module_id

String

参数解释

模块唯一标识ID。

约束限制

不涉及。

取值范围

18~19个字符的数字字符串。

默认取值

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

description

String

参数解释

模块描述信息。

约束限制

不涉及。

取值范围

最大255个字符。

默认取值

不涉及

display_value

String

参数解释

模块名称。

约束限制

不涉及。

取值范围

2~30个字符。

默认取值

不涉及

parent_id

String

参数解释

父模块ID,更新模块层级关系时指定新的父模块。

约束限制

不涉及。

取值范围

18~19个字符的数字字符串。

默认取值

不涉及

assignee

String

参数解释

模块责任人ID。

约束限制

不涉及。

取值范围

32个字符。

默认取值

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

status

String

参数解释

返回状态。

取值范围

  • success:更新模块成功

  • error:更新模块失败

message

String

参数解释

返回消息。

取值范围

不涉及。

result

UpdateModuleResultVO object

参数解释

更新模块返回结果。

表4 UpdateModuleResultVO

参数

参数类型

描述

id

String

参数解释

更新后的模块ID。可以通过查询模块树形列表获取,响应消息体中的id字段的值就是模块ID。

取值范围

18~19个字符的数字字符串。

modified_by

String

参数解释

模块最近修改人ID。

取值范围

32个字符。

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

错误码。

取值范围

不涉及。

error_msg

String

参数解释

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

取值范围

不涉及。

请求示例

PUT https://{endpoint}/v1/ipdprojectservice/projects/b54914d464d1498a97d683ef198ec448/modules/1030877439598833664

{
  "description" : "这是一个更新后的模块描述",
  "display_value" : "更新后的模块名称",
  "parent_id" : "0987654321fedcba0987654321fedcba",
  "assignee" : "fedcba0987654321fedcba0987654321"
}

响应示例

状态码:400

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

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

状态码

状态码

描述

200

更新模块成功

400

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

错误码

请参见错误码

相关文档