华为云用户手册

请求示例 DELETE https://{endpoint}/v4/projects/f7a67aee4c034fd6944fd5f769e89042/issues/5667740/attachments/72372DELETE https://{endpoint}/v4/projects/f7a67aee4c034fd6944fd5f769e89042/issues/5667740/attachments/72372

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户token 表2 请求Body参数 参数 是否必选 参数类型 描述 users 是 Array of UpdateChildUserNickNameRequestBody objects 修改的用户列表 表3 UpdateChildUserNickNameRequestBody 参数 是否必选 参数类型 描述 nick_name 是 String 用户昵称 user_id 是 String 用户id

请求示例 批量更新研发需求 {endpoint}/v1/ipdprojectservice/projects/8e70d806a8f04d018ea6af6b6ffe7b96/issues/batch{ "id" : [ "957294446158852096", "957315051394478080" ], "attribute" : { "category" : "IR", "priority" : "低", "submitted_by" : [ { "id" : "a360371833bf4c558f796fd707b44daf" } ], "labels" : [ { "id" : "956308025419804673" }, { "id" : "956308025419804673" } ], "custom_fields" : [ { "code" : "c7073388365101674496", "value" : "881467547473321986,881467547473321987" }, { "code" : "c7148504958125613056", "value" : "我是一个项目自定义字段" }, { "code" : "module", "value" : "956584293264568320" }, { "code" : "c7148512434669625344", "value" : "956591616891461634" } ] }}

响应示例 状态码： 200 OK { "status" : "success", "result" : [ { "success" : [ { "id" : "957294446158852096", "operator" : "a360371833bf4c558f796fd707b44daf", "operate_time" : "2024-01-29T21:26:11Z" }, { "id" : "957315051394478080", "operator" : "a360371833bf4c558f796fd707b44daf", "operate_time" : "2024-01-29T21:26:11Z" } ], "failed" : [ ] } ]} 状态码： 400 错误原因 { "error_code" : "PM.02175000", "error_msg" : "系统繁忙，请稍后再试"}

响应参数 状态码： 200 表7 响应Body参数 参数 参数类型 描述 result Array of IssueBatchOperateEntitiesResult objects 批量编辑的结果 status String 操作状态 message String 操作失败原因 表8 IssueBatchOperateEntitiesResult 参数 参数类型 描述 success Array of IssueOperateResult objects 成功的结果 failed Array of IssueOperateResult objects 失败的结果 表9 IssueOperateResult 参数 参数类型 描述 id String 变更的工作项id operator String 工作项变更人id state String 工作项变更后生命周期状态 operate_time String 工作项变更时间 状态码： 400 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 id 是 Array of strings 需要更新的工作项ID数组 attribute 否 IssueEntity object 更新的工作项内容 表3 IssueEntity 参数 是否必选 参数类型 描述 id 否 String 工作项id title 否 String 工作项标题 description 否 String 工作项描述字段 type 否 String 工作项大分类定义 requirement(研发需求)、bug(缺陷)、task(任务)、feature(特性)、raw_requirement(原始需求) number 否 String 工作项编号 category 否 String 工作项类型，系统设备类项目可选值为:RR/SF/IR/SR/AR/Task/Bug，独立软件类项目可选值为:RR/SF/IR/US/Task/Bug，云服务类项目可选值为:RR/Epic/FE/US/Task/Bug。 编辑工作项时，此字段必填、值为当前工作项正确的工作项类型，但不会更新此字段 parent_id 否 String 父工作项id project_id 否 String 工作项所属的项目id status 否 String 工作项状态code assignee 否 UserEntity object 工作项责任人 assigned_cc 否 Array of UserEntity objects 工作项抄送人，支持多个抄送人。同一工作项最多支持50个抄送人 created_by 否 UserEntity object 工作项创建人 created_time 否 String 工作项创建时间 modified_by 否 UserEntity object 工作项最近更新人 modified_time 否 String 工作项最近更新时间 plan_end_date 否 String 工作项计划结束日期，时间戳 close_time 否 String 工作项关闭时间 workload 否 String 工作项计划工时，保留一位小数，取值范围为0~999999999.9 link 否 String 工作项关联项id，多个关联项用英文逗号分隔，同一工作项最多支持50个关联项 suspended 否 Boolean 工作项是否已挂起 status_modified_time 否 String 工作项状态改变时间，可用于计算工作项在当前状态停留天数 labels 否 Array of LabelEntity objects 工作项标签 custom_fields 否 Array of FieldCodeValuePair objects 工作项自定义字段映射，用户添加的系统字段也在此列 { "code":"字段code", "value":"字段值" } children 否 Array of IssueEntity objects 工作项的子工作项集合 ir2feature 否 String IR和FE的关联字段，工作项类型为IR时，有此字段 need_break 否 String 工作项是否需要分解,仅可以分解的工作项类型有此字段 break_status 否 String 分解状态 已分解—decomposed 未分解—undecomposed 不涉及— -- baseline 否 String 工作项基线状态 未基线 —— null 已基线 —— baselined 基线评审中——baseline-reviewing priority 否 String 工作项优先级，部分工作项有此字段 related_network_security 否 String 是否涉及网络安全。预设字段中，仅研发需求有此字段 collaboratives 否 String 研发需求协同信息，协同任务id business_domain 否 String 领域字段 plan_pi 否 String 工作项发布(老版本名为PI) id plan_iteration 否 String 工作项完成的迭代，在Bug中为修复迭代 change_status 否 String 工作项变更状态 变更评审中——change-reviewing 已变更——changed 未变更-unchange或null no_break_reason 否 String 无需分解原因，need_break=no时有此字段 submitted_by 否 Array of UserEntity objects 工作项提出人 ir2rr 否 String IR关联的RR id，多选时用英文逗号分隔 feature_set 否 String 特性集id expected_repair_date 否 String 期望修复时间。预设字段中，仅Bug有此字段 found_pi 否 String 缺陷发现发布。预设字段中，仅Bug有此字段 found_iteration 否 String 缺陷发现迭代。预设字段中，仅Bug有此字段 reason_analysis 否 String 分析原因。预设字段中，仅Bug有此字段 repair_solution 否 String 修复方案。预设字段中，仅Bug有此字段 test_report 否 String 测试报告。预设字段中，仅Bug有此字段 sys_no_repair_reason 否 String 无需修复原因。预设字段中，仅Bug有此字段 sys_activation_reason 否 String 激活原因。预设字段中，仅Bug有此字段 sys_return_reason 否 String 退回原因。预设字段中，仅Bug有此字段 test_failures_times 否 Integer 回归不通过次数。预设字段中，仅Bug有此字段 close_type 否 String 关闭类型。预设字段中，仅Bug有此字段;可选值为 问题解决关闭,问题转需求关闭,重复问题关闭,非问题关闭 表4 UserEntity 参数 是否必选 参数类型 描述 id 否 String 用户Id name 否 String 用户名称 nick_name 否 String 用户昵称 表5 LabelEntity 参数 是否必选 参数类型 描述 id 否 String 标签id label_type 否 String 标签所属工作项类型，对应工作项的type字段 color 否 String 标签颜色RGB title 否 String 标签标题 表6 FieldCodeValuePair 参数 是否必选 参数类型 描述 code 否 String 工作项字段code值 value 否 String 工作项自定义字段值，为多选时用英文逗号分隔

响应参数 状态码： 201 表4 响应Body参数 参数 参数类型 描述 id Integer 迭代id 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

URI POST /v4/projects/{project_id}/iteration 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释：项目的32位uuid，项目唯一标识，可以通过ListProjectsV4接口查询项目列表 约束限制：正则表达式， ^[A-Za-z0-9]{32}$ 取值范围：字符串，最小长度：32，最大长度：32 默认取值：不涉及

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释：用户Token。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制：不涉及 取值范围：最小长度：10，最大长度：32768 默认取值：不涉及 表3 请求Body参数 参数 是否必选 参数类型 描述 begin_time 是 String 参数解释：开始时间，年-月-日 约束限制：正则表达式，^[1-9]\d{3}-(0?[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$ 取值范围：匹配格式为 YYYY-MM-DD 的日期字符串，MM 是两位数的月份限制取值01-12，DD是两位数的日期限制取值01-31 默认取值：不涉及 description 否 String 参数解释：迭代的描述 约束限制：可以为空 取值范围：最小长度：0 最大长度：500 默认取值：不涉及 end_time 是 String 参数解释：结束时间，年-月-日 约束限制：正则表达式，^[1-9]\d{3}-(0?[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])$ 取值范围：匹配格式为 YYYY-MM-DD 的日期字符串，MM 是两位数的月份限制取值01-12，DD是两位数的日期限制取值01-31 默认取值：不涉及 name 是 String 参数解释：标题 约束限制：不涉及 取值范围：最小长度：1 最大长度：255 默认取值：不涉及

错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 表1 错误码 状态码 错误码 错误信息 描述 处理措施 400 PM.02150010 目标用户非项目空间成员 目标用户非项目空间成员 将需要的用户先添加到项目空间 400 PM.02150301 删除失败 删除失败 将是这个角色的用户先修改成其他的角色，再删除 400 PM.02150302 所设置权限不可变更 所设置权限不可变更 所设置权限不可变更 400 PM.02150303 角色不存在 角色不存在 核实请求参数 400 PM.02150304 角色名不可用，请设置新名称 角色名不可用，请设置新名称 请设置新名称 400 PM.02150305 角色名冲突 角色名冲突 请设置新名称 400 PM.02150404 项目空间不存在 项目空间不存在 项目空间不存在 400 PM.02151001 项目集不存在 项目集不存在 项目集不存在 400 PM.02152001 参数错误 参数错误 参数错误 400 PM.02152002 未定义错误 未定义错误 未定义错误 400 PM.02152003 传入参数名非法 传入参数名非法 传入参数名非法 400 PM.02152004 项目集未归档 项目集未归档 项目集未归档 400 PM.02152005 项目不存在或项目已被删除 项目不存在或项目已被删除 项目不存在或项目已被删除 400 PM.02152006 该项目集还没有被关注 该项目集还没有被关注 该项目集还没有被关注 400 PM.02152007 已关注该项目集 已关注该项目集 已关注该项目集 400 PM.02152008 修改创建项目集权限的参数含有非法用户 修改创建项目集权限的参数含有非法用户 修改创建项目集权限的参数含有非法用户 400 PM.02152009 项目集已归档 项目集已归档 项目集已归档 400 PM.02152010 项目类型不被允许 项目类型不被允许 项目类型不被允许 400 PM.02152011 项目已被关联 项目已被关联 项目已被关联 400 PM.02153001 访问频率过高，请稍后再试 访问频率过高，请稍后再试 访问频率过高，请稍后再试 400 PM.02175006 CN: 参数错误: {0}; EN: Invalid Parameter: {0} 参数错误 使用正确的请求参数重试 400 PM.02175101 CN: 子节点数量超过限制：{0}; Number of sub items exceeds [{0}] 子节点数量不能超过限制 删除其他子节点后再创建，或者在其他父节点下创建 400 PM.02175103 CN: 无法修改未被接纳或已拒绝的IR; EN: Only accepted initial requirement can be edited 当前IR无法被修改（只有当提出项目空间与归属项目空间相同，或者在归属项目空间被接纳的IR才能被修改。修改IR或者在父IR下创建子项时可能发生此错误） 确认修改的IR的状态后重试 400 PM.02175104 CN: 所选IR无法操作; EN: Some of the initial requirements can not be edited 部分IR无法修改（通常是因为部分请求的IR不存在） 确认所有修改的IR都存在后重试 400 PM.02175105 CN: 无效的父IR; EN: Invalid parent. 无效的父IR（此错误发生于批量创建子IR时，父IR不一致，或者父IR的归属项目空间与子IR的提出项目空间不一致，或者指定的父IR类型不正确） 使用正确的请求参数重试 400 PM.02175106 CN: 子IR必须提给其他项目空间; EN: Can not create sub ir to current program. 子IR的提出项目空间与归属项目空间不能相同 将子IR提给其他项目空间 400 PM.02175111 CN: 当前IR下有子IR，不能删除; EN: Child IR exist, can not delete. 不能删除具有子IR的父IR 删除所有子IR后再删除父IR 400 PM.02175113 CN: 父IR不存在; EN: Parent IR not exists. 父IR不存在 在正确的父IR下创建子IR 400 PM.02175114 CN: 父IR不归属于当前项目空间，请到父IR的归属项目空间进行操作; EN: Parent IR not designated in current program, please perform in the destination program of this IR. 父IR不归属于当前项目空间 到父IR的归属项目空间中重试 400 PM.02175115 CN: 不能删除IR：不具有所有子工作项所在项目的编辑权限; EN: Missing edit permission of sub items. 不能删除IR，因为不具有所有子工作项所在项目的编辑权限 申请子工作项所在项目的编辑权限后重试 400 PM.02175200 CN: 缺少必填字段 [{0}]; EN: Missing required field [{0}] 缺少必填字段 添加必填字段后重试 400 PM.02175201 CN: 字段 [{0}] 的值不正确{1}; EN: Field [{0}] has invalid value{1} IR字段的值不正确（无具体原因时，通常是格式错误，比如时间/日期字段使用了非时间戳字符串） 使用正确的值进行请求 400 PM.02175202 CN: 预计开始日期不能晚于预计结束日期; EN: Plan start date can not be later than plan due date. 预计开始日期不能晚于预计结束日期 使用正确的预计开始日期/预计结束日期参数 400 PM.10001002 不合法的token 不合法的token 不合法的token 400 PM.10002006 当前租户下名称已被使用 当前租户下名称已被使用 当前租户下名称已被使用 400 PM.10002010 描述不超过500个字符 描述不超过500个字符 描述不超过500个字符 400 PM.10002011 名称不规范 名称不规范 名称不规范 400 PM.10003002 当前用户权限不足 当前用户权限不足 当前用户权限不足 400 PM.10003003 邀请已过期 邀请已过期 邀请已过期 400 PM.10003004 审核信息不存在 审核信息不存在 审核信息不存在 400 PM.10003005 标签在使用中 标签在使用中 标签在使用中 400 PM.10003006 添加成员最多不超过100个 添加成员最多不超过100个 添加成员最多不超过100个 400 PM.10003007 最多可以添加100个项目 最多可以添加100个项目 最多可以添加100个项目 400 PM.10003008 角色不被允许 角色不被允许 角色不被允许 400 PM.10003009 创建者移交项目空间后可以退出项目 创建者移交项目空间后可以退出项目 创建者移交项目空间后可以退出项目 400 PM.10003010 成员已不存在 成员已不存在 成员已不存在 400 PM.10003011 租户下项目空间总数不能超过100个 租户下项目空间总数不能超过100个 租户下项目空间总数不能超过100个 400 PM.10003014 邀请不存在 邀请不存在 邀请不存在 400 PM.10003015 只能添加同租户下用户 只能添加同租户下用户 只能添加同租户下用户 400 PM.10003016 添加成员失败 添加成员失败 添加成员失败 401 PM.02150401 用户操作权限不足 用户操作权限不足 用户操作权限不足 403 PM.10003012 用户是项目空间成员，不需要申请 用户是项目空间成员，不需要申请 用户是项目空间成员，不需要申请 404 PM.02175005 CN: 当前请求资源不存在; EN: Requested resource not exist 查询的资源不存在 确认请求的资源是否存在（可能输入了错误的id，或资源已被删除） 405 PM.10003013 已存在加入项目空间的申请，等待管理员审批 已存在加入项目空间的申请，等待管理员审批 已存在加入项目空间的申请，等待管理员审批

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 状态 message String 错误信息 result FeatureSetOperateParam object 特性集创建、修改参数 表4 FeatureSetOperateParam 参数 参数类型 描述 id String 特性集Id title String 特性集标题 position_float Float 特性集在目录树中的相对位置，从0F开始的浮点数，不支持科学计数法 parent_id String 父特性集Id,必填参数。 更新时需要移动特性集目录传入目标特性集Id，仅修改位置、标题属性时需要传入原父Id

响应示例 状态码： 200 工时信息以及工时总和信息返回 { "status" : "success", "message" : null, "result" : { "data" : [ { "id" : "1038556057215868930", "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_s00404480_01", "nick_name" : "t" } } ], "work_hours_total" : 0 }}

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 状态 message String 消息 result WorkHourTotalVO object 工时信息及工时总数 表3 WorkHourTotalVO 参数 参数类型 描述 data Array of WorkHourVO objects 工时信息列表 work_hours_total String 实际工时总数 表4 WorkHourVO 参数 参数类型 描述 id String 工时id description String 描述 workitem_id String 工作项id work_date String 工时日期 created_by UserEntity object 创建人信息 modified_by UserEntity object 修改人信息 work_hour_category String 工时类型唯一标识取值为value，页面展示取值为display_value work_hours String 花费工时(人天) 表5 UserEntity 参数 参数类型 描述 id String 用户Id name String 用户名称 nick_name String 用户昵称

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 请求状态 message String 请求失败原因 result LabelEntity object 标签详情 表3 LabelEntity 参数 参数类型 描述 id String 标签id label_type String 标签所属工作项类型，对应工作项的type字段 color String 标签颜色RGB title String 标签标题

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 状态 message String 消息 result WorkHourTotalVO object 工时信息及工时总数 表4 WorkHourTotalVO 参数 参数类型 描述 data Array of WorkHourVO objects 工时信息列表 work_hours_total String 实际工时总数 表5 WorkHourVO 参数 参数类型 描述 id String 工时id description String 描述 workitem_id String 工作项id work_date String 工时日期 created_by UserEntity object 创建人信息 modified_by UserEntity object 修改人信息 work_hour_category String 工时类型唯一标识取值为value，页面展示取值为display_value work_hours String 花费工时(人天) 表6 UserEntity 参数 参数类型 描述 id String 用户Id name String 用户名称 nick_name String 用户昵称 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求示例 创建总数为100，开始时间从2024/02/01至2024/02/06，工时类型为研发设计，包含周末的工时数据 {url}/v1/ipdprojectservice/projects/05c7d8bcf3db4829bc841e4ba93aaea5/work-items/976857692367659008/work-hour?_=1708329665577{ "work_hour_category" : "研发设计", "work_date_begin" : "2024/02/01", "work_date_end" : "2024/02/02", "work_hours" : "12", "work_hour_type" : 1, "include_weekend" : true, "description" : "工作内容工作内容工作内容"}

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 work_hour_category 否 String 工时类型唯一标识取值为value，页面展示取值为display_value work_date_begin 是 String 工时开始日期 work_date_end 是 String 工时结束日期 work_hours 是 String 工时数值 work_hour_type 是 String 工时类型：1：总数 2：每天 include_weekend 是 Boolean 是否包含周末 description 否 String 描述

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：10 最大长度：32768 表2 请求Body参数 参数 是否必选 参数类型 描述 project_name 是 String 项目名称 最小长度：1 最大长度：128 description 否 String 项目描述 source 否 String 项目来源 project_type 是 String 项目类型 scrum, xboard(看板项目), basic, phoenix(凤凰项目) enterprise_id 否 String 项目要绑定的企业项目ID template_id 否 Integer 用户创建的项目模板id

响应示例 状态码： 200 OK { "project_num_id" : 708168641, "project_name" : "testdemo", "project_id" : "2e76d6f0b2c5403796e36bf63c5d5561", "user_num_id" : 700145037, "project_type" : "scrum", "description" : "this is demo"} 状态码： 400 Bad Request { "error_msg" : "param error", "error_code" : "PM.00000001"}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 project_num_id Integer 项目数字id project_id String 项目id 最小长度：32 最大长度：32 project_name String 项目名 最小长度：1 最大长度：128 description String 项目描述 project_type String 项目类型 user_num_id Integer 创建者的数字id 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 请求状态 message String 请求失败信息 result ModuleEntity object 模块详情 表3 ModuleEntity 参数 参数类型 描述 id String 模块id sequence String 模块顺序值。double类型 level Integer 模块层级，最多3层 description String 模块描述信息 created_by String 模块创建人id created_time String 模块创建时间 modified_by String 模块最近修改人id modified_time String 模块最近修改时间 display_value String 模块显示名 path_name String 子模块的路径名 value String 模块唯一标识，自定义模块value和id项目 parent_id String 父模块id child_modules Array of ModuleEntity objects 子模块 assignee String 模块责任人id

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 domain_name String 领 域名 称 domain_id String 领域id 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 issues Array of AssociateIssueDetail objects 关联的工作项列表 total Integer 总数 表5 AssociateIssueDetail 参数 参数类型 描述 subject String 工作项标题 issue_id Integer 工作项ID project SimpleProject object 项目 user SimpleUser object 用户 status StatusVo object 状态 表6 SimpleProject 参数 参数类型 描述 project_name String 项目名称 project_id String 项目id 表7 SimpleUser 参数 参数类型 描述 user_num_id Integer 用户数字id user_id String 用户uuid user_name String 账号名 nick_name String 用户昵称 表8 StatusVo 参数 参数类型 描述 id String 状态id name String 状态id对应的值 状态码： 400 表9 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表10 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

响应示例 状态码： 200 { "issues" : [ { "subject" : "demo", "issue_id" : 1234, "project" : { "project_name" : "demo", "project_id" : "58d9050550c847c89885c1797a718b0c" }, "user" : { "user_num_id" : 4091, "user_id" : "a360371833bf4c558f796fd707b44daf", "user_name" : "demo_user_name_xiongzhitest001", "nick_name" : "bear" }, "status" : { "id" : "1", "name" : "未开始" } } ], "total" : 12}

URI GET /v4/projects/{project_id}/issues/{issue_id}/associated-issues 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String devcloud项目的32位id 最小长度：32 最大长度：32 issue_id 是 Integer 工作项ID 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 每页数量 offset 否 Integer 偏移量

响应示例 状态码： 200 OK { "description" : "module demo", "module_name" : "demo", "module_id" : 46691, "owner" : { "user_id" : "09d75cde5180d4481f91c018e89cb8e2", "user_num_id" : 4091, "user_name" : "demo_user_name_06", "nick_name" : "模块demo" }}

请求示例 Post https://{endpoint}/v4/projects/0792b7d26cb74bd799cbae80063dc74a/modules{ "description" : "module demo", "module_name" : "demo", "parent_module_id" : 1, "owner" : { "user_id" : "09d75cde5180d4481f91c018e89cb8e2" }}

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 description String 模块描述 module_name String 模块名称 module_id Integer 模块id owner ModuleOwner object 模块责任人 表6 ModuleOwner 参数 参数类型 描述 user_id String 用户32位字符串id user_num_id Integer 用户数字id user_name String 用户名称 nick_name String 用户昵称 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 description 否 String 模块描述 module_name 是 String 模块名称 parent_module_id 否 Integer 父模块id owner 是 UserRequest object 模块责任人 表4 UserRequest 参数 是否必选 参数类型 描述 user_id 是 String 用户32位字符串id

响应示例 状态码： 200 OK { "actual_work_hours" : 0, "assigned_cc_user" : [ { "id" : 4091, "name" : "user_name_demo", "nick_name" : "nick_name_demo" } ], "assigned_user" : { "id" : 4091, "name" : "user_name_demo", "nick_name" : "nick_name_demo" }, "begin_time" : "2020-09-12", "creator" : { "id" : 4091, "name" : "user_name_demo", "nick_name" : "nick_name_demo" }, "custom_fields" : [ { "name" : "customField16", "value" : "多选框", "new_name" : "custom_field16" } ], "new_custom_fields" : [ { "custom_field" : "custom_field16", "field_name" : "field_name", "value" : "select1,select2" } ], "developer" : { "id" : 4091, "name" : "user_name_demo", "nick_name" : "nick_name_demo" }, "domain" : { "id" : 14, "name" : "性能" }, "done_ratio" : 0, "end_time" : "2020-09-19", "expected_work_hours" : 9, "id" : 4567, "project" : { "project_id" : "526cefde62004de2b62b5e8dd2c2b3af", "project_name" : "testDemo", "project_num_id" : 78953 }, "iteration" : { "id" : 456, "name" : "iteration_1" }, "module" : { "id" : 456, "name" : "Project" }, "parent_issue" : { "id" : 123, "name" : "paren_issue_demo" }, "priority" : { "id" : 1, "name" : "低" }, "severity" : { "id" : 12, "name" : "一般" }, "status" : { "id" : 1, "name" : "新建" }, "tracker" : { "id" : 7, "name" : "story" }}