# 批量创建工作项 - BatchCreateIpdIssuesV2
#### 功能介绍
批量创建工作项。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST /v2/ipdprojectservice/projects/{project_id}/issues/batch
表1路径参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| project_id | 是 | String | **参数解释**： 项目32位ID，项目唯一标识。通过[查询IPD项目列表](https://support.huaweicloud.com/api-projectman/ShowIpdProjectList.html)获取，响应消息体中的**id**字段的值就是项目ID。 **约束限制**： 不涉及。 **取值范围**： 32个字符，由英文字母和数字组成。 **默认取值**： 不涉及。 |
#### 请求参数
表2请求Header参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| X-Auth-Token | 是 | String | **参数解释**： 用户Token。通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制**： 不涉及。 **取值范围**： 10\~32768个字符。 **默认取值**： 不涉及。 |
表3请求Body参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| \[数组元素\] | 是 | Array of [IssueCreateEntity] objects | 工作项创建对象 |
表4IssueCreateEntity
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| title | 是 | String | **参数解释**： 工作项标题。 **约束限制**： 不涉及。 **取值范围**： 2\~256个字符。 **默认取值**： 不涉及。 |
| description | 是 | String | **参数解释**： 工作项描述字段。 **约束限制**： 不涉及。 **取值范围**： 0\~500000个字符。 **默认取值**： 不涉及。 |
| category | 是 | String | **参数解释**： 工作项类型编码。编辑工作项时，此字段必填、值为当前工作项正确的工作项类型，但不会更新此字段。 **约束限制**： 不涉及。 **取值范围**： 支持多种工作项类型，使用英文逗号分隔。 - 系统设备类项目：RR、SF、IR、SR、AR、Task、Bug - 独立软件类项目：RR、SF、IR、US、Task、Bug - 云服务类项目：RR、Epic、FE、US、Task、Bug **默认取值**： 不涉及。 |
| category_layer_id | 是 | String | **参数解释**： 工作项类型层级关系ID，此参数影响工作项的层级显示。通过[获取模型树配置信息](https://support.huaweicloud.com/api-projectman/GetModelConfig.html)获取，根据参数中的category在响应消息体中category_layer_config中找到对应的category_code，和category_code同级的id就是工作项类型层级关系ID。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| parent_id | 是 | String | **参数解释**： 父工作项ID。 **约束限制**： 创建子工作项时必填，其他场景非必填。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| status | 是 | String | **参数解释**： 工作项状态code。可通过[查询工作项状态](https://support.huaweicloud.com/api-projectman/ListIssueStatues.html)接口获取，响应消息体中的**code**字段的值就是工作项状态code。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| assignee | 是 | [UserEntity] object | **参数解释**： 工作项责任人。 **约束限制**： Bug必填。其他工作项类型非必填，默认责任人为当前用户。 |
| recipient | 否 | Array of [UserEntity] objects | **参数解释**： 原始需求承接人。 **约束限制**： 当工作项类型为RR时字段必填，其他工作项类型无此字段。 |
| assigned_cc | 否 | Array of [UserEntity] objects | **参数解释**： 工作项抄送人，支持多个抄送人。 **约束限制**： 同一工作项最多支持50个抄送人。 |
| plan_end_date | 否 | String | **参数解释**： 工作项计划结束日期。 **约束限制**： 0\~13个字符的数字字符串，可选负号前缀。 **取值范围**： 时间戳。 **默认取值**： 不涉及。 |
| workload | 否 | String | **参数解释**： 工作项计划工时。 **约束限制**： 不涉及。 **取值范围**： 0\~999999999.9中的数字字符串。 **默认取值**： 不涉及。 |
| link | 否 | String | **参数解释**： 工作项关联项ID。 **约束限制**： 多个关联项用英文逗号分隔，同一工作项最多支持50个关联项。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| labels | 否 | Array of [LabelEntity] objects | **参数解释**： 工作项标签。 **约束限制**： 不涉及。 |
| custom_fields | 否 | Array of [FieldCodeValuePair] objects | **参数解释**： 工作项自定义字段映射。用户添加的系统字段也在此列。 **约束限制**： 不涉及。 |
| ir2feature | 否 | String | **参数解释**： IR和SF的关联字段。 **约束限制**： IR可以填写该字段。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| priority | 否 | String | **参数解释**： 工作项优先级。 **约束限制**： RR、SF、FE、IR、SR、AR、Task、Bug可以填写该字段。 **取值范围**： - 低：低优先级。 - 中：中优先级。 - 高：高优先级。 **默认取值**： 不涉及。 |
| related_network_security | 否 | String | **参数解释**： 是否涉及网络安全。 **约束限制**： 仅研发需求有此字段。 **取值范围**： - yes：涉及网络安全。 - no：不涉及网络安全。 **默认取值**： 不涉及。 |
| collaboratives | 否 | String | **参数解释**： 研发需求协同信息，协同任务ID，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**collaboratives**字段的值就是研发需求协同信息，协同任务ID。 **约束限制**： 协同任务ID。IR、SR、AR、US有此字段。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| business_domain | 否 | String | **参数解释**： 领域字段。 **约束限制**： FE、SF、IR、SR、AR、Bug有此字段。 **取值范围**： - software - soft-hardware - hardware - 性能 - 功能 - 运维 - 运营 - 用户体验 - 隐私保护 - 合规 - 韧性(可靠性/可用性) - 韧性(危险检测与相应恢复) - 透明 - 无害 - 安全 - API - 成本 - 可维护性 - 其他DFX - 可用性 - others **默认取值**： 不涉及。 |
| plan_pi | 否 | String | **参数解释**： 工作项发布计划ID。 **约束限制**： 默认SR、AR、US、Task、Bug有此字段。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| submitted_by | 否 | Array of [UserEntity] objects | **参数解释**： 工作项提出人。 **约束限制**： 仅RR、Bug有此字段。 |
| ir2rr | 否 | String | **参数解释**： IR关联的RR的Id。 **约束限制**： 仅IR有此字段，多选时用英文逗号分隔。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| feature_set | 否 | String | **参数解释**： 特性集ID。 **约束限制**： 仅SF/FE有此字段。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
表5UserEntity
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| id | 否 | String | **参数解释**： 用户ID，可通过[查询项目成员列表](https://support.huaweicloud.com/api-projectman/ListProjectUsers.html)接口获取，响应消息体中的**id**字段的值就是用户ID。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| name | 否 | String | **参数解释**： 用户名称。 **约束限制**： 不涉及。 **取值范围**： 2\~64个字符。 **默认取值**： 不涉及。 |
| nick_name | 否 | String | **参数解释**： 用户昵称。 **约束限制**： 不涉及。 **取值范围**： 2\~30个字符。 **默认取值**： 不涉及。 |
表6LabelEntity
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| id | 否 | String | **参数解释**： 标签ID，可通过[查询标签列表](https://support.huaweicloud.com/api-projectman/ListIpdLabels.html)接口获取，响应消息体中的**id**字段的值就是标签ID。 **约束限制**： 不涉及。 **取值范围**： 18\~19个字符的数字字符串。 **默认取值**： 不涉及。 |
| category_types | 否 | Array of strings | **参数解释**： 标签所属工作项类型编码。 **约束限制**： 不涉及。 **默认取值**： 不涉及。 |
| label_type | 否 | String | **参数解释**： 标签所属工作项类型，对应工作项的type字段，枚举类型。 **约束限制**： 不涉及。 **取值范围**： - raw requirement：原始需求 - feature：系统特性 - requirement：研发需求 - task：任务 - bug：缺陷 **默认取值**： 不涉及。 |
| color | 否 | String | **参数解释**： 标签颜色RGB。 **约束限制**： 0\~16个字符。 **取值范围**： 可选颜色代码与对应中文描述如下： - #86CAFF：浅蓝色 - #6DDEBB：青绿色 - #A6DD82：黄绿色 - #FAC20A：金黄色 - #FA9841：橙色 - #F66F6A：珊瑚红 - #F3689A：粉红色 - #A97AF8：淡紫色 - #71757F：中性灰 - #5E7CE0：宝蓝色 - #207AB3：深蓝色 - #169E6C：翠绿色 - #6CA83B：草绿色 - #B58200：棕黄色 - #B54E04：赭石色 - #B02121：朱红色 - #AD215B：玫红色 - #572DB3：深紫色 - #4F4F4F：深灰色 - #3C51A6：靛蓝色 **默认取值**： 不涉及。 |
| title | 否 | String | **参数解释**： 标签标题。 **约束限制**： 1\~30个字符。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
表7FieldCodeValuePair
| 参数 | 是否必选 | 参数类型 | 描述 |
|:---|:---|:---|:---|
| code | 否 | String | **参数解释**： 工作项自定义字段code值。可选值可以通过[查询字段模板列表](https://support.huaweicloud.com/api-projectman/ListIssueFields.html)接口获取，响应体中的**code**就是字段唯一标识。 **约束限制**： 0\~32个字符。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| value | 否 | String | **参数解释**： 工作项自定义字段值。 **约束限制**： 为多选时用英文逗号分隔。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
#### 响应参数
**状态码：200**
表8响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| result | Array of [IssueCreateResponse] objects | **参数解释**： 创建的工作项返回值。 |
| status | String | **参数解释**： 返回状态。 **取值范围**： success：响应成功。 error：响应失败 |
| message | String | **参数解释**： 失败原因。 **取值范围**： 不涉及。 |
表9IssueCreateResponse
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| id | String | **参数解释**： 需要更新的工作项ID，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**id**字段的值就是工作项ID。 **取值范围**： 不涉及。 |
| title | String | **参数解释**： 工作项标题，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**title**字段的值就是工作项标题。 **取值范围**： 不涉及。 |
| description | String | **参数解释**： 工作项描述字段，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**description**字段的值就是工作项描述字段。 **取值范围**： 不涉及。 |
| type | String | **参数解释**： 工作项大分类定义。工作项创建、编辑无此字段，仅作展示用，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**type**字段的值就是工作项大分类定义。 **取值范围**： requirement(研发需求)，bug(缺陷)，task(任务)，feature(特性)，raw_requirement(原始需求)。 |
| number | String | **参数解释**： 工作项编号，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**number**字段的值就是工作项编号。 **取值范围**： 不涉及。 |
| category | String | **参数解释**： 工作项类型，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**category**字段的值就是工作项类型。 **取值范围**： 支持多种工作项类型，使用英文逗号分隔。 - 系统设备类项目：RR、SF、IR、SR、AR、Task、Bug - 独立软件类项目：RR、SF、IR、US、Task、Bug - 云服务类项目：RR、Epic、FE、US、Task、Bug |
| parent_id | String | **参数解释**： 父工作项ID，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**parent_id**字段的值就是父工作项ID。 **取值范围**： 不涉及。 |
| project_id | String | **参数解释**： 项目的32位UUID，项目唯一标识，通过查询项目列表接口获取，响应消息体中的**project_id**字段的值就是项目ID。 **取值范围**： 不涉及 |
| status | String | **参数解释**： 工作项状态code，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**status**字段的值就是工作项状态code。 **取值范围**： 不涉及。 |
| state | String | **参数解释**： 工作项的生命周期，可选值为"正在工作"，"作废"，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**state**字段的值就是工作项的生命周期。 **取值范围**： 正在工作，作废。 |
| assignee | [UserEntity] object | **参数解释**： 工作项责任人。 |
| assigned_cc | Array of [UserEntity] objects | **参数解释**： 工作项抄送人，支持多个抄送人。同一工作项最多支持50个抄送人。 |
| created_by | [UserEntity] object | **参数解释**： 工作项创建人。 |
| created_time | String | **参数解释**： 工作项创建时间，unix时间戳，单位：毫秒。 **取值范围**： 不涉及。 |
| modified_by | [UserEntity] object | **参数解释**： 工作项最近更新人。 |
| modified_time | String | **参数解释**： 工作项最近更新时间，unix时间戳，单位：毫秒。 **取值范围**： 不涉及。 |
| plan_end_date | String | **参数解释**： 工作项计划结束日期，unix时间戳，单位：毫秒。 **取值范围**： 不涉及。 |
| close_time | String | **参数解释**： 工作项关闭时间，unix时间戳，单位：毫秒。 **取值范围**： 不涉及。 |
| workload | String | **参数解释**： 工作项计划工时，保留一位小数，取值范围为0\~999999999.9。 **取值范围**： 0\~999999999.9。 |
| workload_sum | String | **参数解释**： 工作项实际工时。 **取值范围**： 0\~999999999.9。 |
| tenant_id | String | **参数解释**： 工作项所属租户ID，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**tenant_id**字段的值就是工作项所属租户ID。 **取值范围**： 不涉及。 |
| link | String | **参数解释**： 工作项关联项ID，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**link**字段的值就是工作项关联项ID。 **取值范围**： 不涉及。 |
| suspended | Boolean | **参数解释**： 工作项是否已挂起。 **取值范围**： true，false。 |
| status_modified_time | String | **参数解释**： 工作项状态改变时间，可用于计算工作项在当前状态停留天数，unix时间戳，单位：毫秒。 **取值范围**： 不涉及。 |
| labels | Array of [LabelEntity] objects | **参数解释**： 工作项标签。 |
| custom_fields | Array of [FieldCodeValuePair] objects | **参数解释**： 工作项自定义字段映射，用户添加的系统字段也在此列。 { "code":"字段code", "value":"字段值" }。 |
| children | Array of [IssueEntity] objects | **参数解释**： 工作项的子工作项集合。 |
| path | String | **参数解释**： 子工作项的路径。 **取值范围**： 不涉及。 |
| ir2feature | String | **参数解释**： IR和SF的关联字段。 **取值范围**： 不涉及。 |
| need_break | String | **参数解释**： 工作项是否需要分解。 **取值范围**： - yes：需要分解 - no：不需要分解 |
| break_status | String | **参数解释**： 分解状态。 已分解（decomposed） 未分解（undecomposed） 不涉及（ --）。 **取值范围**： decomposed，undecomposed，--。 |
| baseline | String | **参数解释**： 工作项基线状态。 **取值范围**： - null：未基线 - baselined：已基线 - baseline-reviewing：基线评审中 |
| priority | String | **参数解释**： 工作项优先级，部分工作项有此字段。 **取值范围**： - 低：低优先级。 - 中：中优先级。 - 高：高优先级。 |
| related_network_security | String | **参数解释**： 是否涉及网络安全。 **取值范围**： 不涉及。 **取值范围**： - yes：涉及网络安全。 - no：不涉及网络安全。 |
| collaboratives | String | **参数解释**： 研发需求协同信息，协同任务ID，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**collaboratives**字段的值就是研发需求协同信息，协同任务ID。 **取值范围**： 不涉及。 |
| business_domain | String | **参数解释**： 领域字段。 **取值范围**： - software - soft-hardware - hardware - 性能 - 功能 - 运维 - 运营 - 用户体验 - 隐私保护 - 合规 - 韧性(可靠性/可用性) - 韧性(危险检测与相应恢复) - 透明 - 无害 - 安全 - API - 成本 - 可维护性 - 其他DFX - 可用性 - others |
| plan_pi | String | **参数解释**： 工作项发布计划ID，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**plan_pi**字段的值就是工作项发布计划ID。 **取值范围**： 不涉及。 |
| plan_iteration | String | **参数解释**： 工作项完成的迭代计划ID，在Bug中为修复迭代计划ID，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**plan_iteration**字段的值就是迭代计划ID。 **取值范围**： 不涉及。 |
| change_status | String | **参数解释**： 工作项变更状态。 变更评审中（change-reviewing） 已变更（changed） 未变更（unchange或null）。 **取值范围**： change-reviewing，changed，unchange，null。 |
| no_break_reason | String | **参数解释**： 无需分解原因。 **取值范围**： 0\~512个字符。 |
| submitted_by | Array of [UserEntity] objects | **参数解释**： 工作项提出人。 |
| ir2rr | String | **参数解释**： IR关联的RR ID，多选时用英文逗号分隔。 **取值范围**： 不涉及。 |
| feature_set | String | **参数解释**： 特性集ID，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**feature_set**字段的值就是特性集ID。 **取值范围**： 不涉及。 |
| expected_repair_date | String | **参数解释**： 期望修复时间。预设字段中，仅Bug有此字段，unix时间戳，单位：毫秒。 **取值范围**： 不涉及。 |
| found_pi | String | **参数解释**： 缺陷发现发布计划ID，预设字段中，仅Bug有此字段，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**found_pi**字段的值就是缺陷发现发布计划ID。 **取值范围**： 不涉及。 |
| found_iteration | String | **参数解释**： 缺陷发现迭代计划ID，预设字段中，仅Bug有此字段，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**found_iteration**字段的值就是缺陷发现迭代计划ID。 **取值范围**： 不涉及。 |
| reason_analysis | String | **参数解释**： 分析原因。 **取值范围**： 0\~50000个字符。 |
| 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有此字段，可选值为problem_solved，problem_to_requirement，duplicate_problem，not_a_problem。分别对应问题解决关闭，问题转需求关闭，重复问题关闭，非问题关闭。 **取值范围**： problem_solved，problem_to_requirement，duplicate_problem，not_a_problem。 |
表10IssueEntity
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| id | String | **参数解释**： 需要更新的工作项ID，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**id**字段的值就是工作项ID。 **取值范围**： 18\~19位的数字字符串(工作项的**id**字段对应的字符串)。 |
| title | String | **参数解释**： 工作项标题，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**title**字段的值就是工作项标题。 **取值范围**： 1\~256个字符。 |
| description | String | **参数解释**： 工作项描述字段，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**description**字段的值就是工作项描述字段。 **取值范围**： 1\~500000个字符。 |
| type | String | **参数解释**： 工作项大分类定义。工作项创建、编辑无此字段，仅作展示用，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**type**字段的值就是工作项大分类定义。 **取值范围**： - requirement：研发需求 - bug：缺陷 - task：任务 - feature：特性 - raw_requirement：原始需求 |
| number | String | **参数解释**： 工作项编号，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**number**字段的值就是工作项编号。 **取值范围**： 不涉及。 |
| category | String | **参数解释**： 工作项类型，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**category**字段的值就是工作项类型。 **取值范围**： 支持多种工作项类型，使用英文逗号分隔。 - 系统设备类项目：RR、SF、IR、SR、AR、Task、Bug - 独立软件类项目：RR、SF、IR、US、Task、Bug - 云服务类项目：RR、Epic、FE、US、Task、Bug |
| category_layer_id | String | **参数解释**： 工作项类型层级关系ID，此参数影响工作项的层级显示。通过[获取模型树配置信息](https://support.huaweicloud.com/api-projectman/GetModelConfig.html)获取，根据参数中的category在响应消息体中category_layer_config中找到对应的category_code，和category_code同级的id就是工作项类型层级关系ID。 **取值范围**： 不涉及。 |
| parent_id | String | **参数解释**： 父工作项ID，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**parent_id**字段的值就是父工作项ID。 **取值范围**： 18\~19位的数字字符串(父工作项的**id**字段对应的字符串)。 |
| project_id | String | **参数解释**： 项目的32位UUID，项目唯一标识，通过[查询IPD项目列表](https://support.huaweicloud.com/api-projectman/ShowIpdProjectList.html)接口获取，响应消息体中的**project_id**字段的值就是项目ID。 **取值范围**： 通过[查询IPD项目列表](https://support.huaweicloud.com/api-projectman/ShowIpdProjectList.html)接口获取的32个字符的项目唯一标识。 |
| status | String | **参数解释**： 工作项状态code。可通过[查询工作项状态](https://support.huaweicloud.com/api-projectman/ListIssueStatues.html)接口获取，响应消息体中的**code**字段的值就是工作项状态code。 **取值范围**： 2\~32个字符。 |
| state | String | **参数解释**： 工作项的生命周期，可选值为"正在工作"，"作废"，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**state**字段的值就是工作项的生命周期。 **取值范围**： - 正在工作：可正常操作的工作项 - 作废：软删除后的工作项，可在回收站恢复 - 删除：彻底删除后的工作项，无法恢复 |
| assignee | [UserEntity] object | **参数解释**： 工作项责任人。 |
| assigned_cc | Array of [UserEntity] objects | **参数解释**： 工作项抄送人，支持多个抄送人。数组元素为UserEntity对象。 **取值范围**： 不涉及。 |
| created_by | [UserEntity] object | **参数解释**： 工作项创建人。 |
| created_time | String | **参数解释**： 工作项创建时间，unix时间戳，单位：毫秒。 **取值范围**： 不涉及。 |
| modified_by | [UserEntity] object | **参数解释**： 工作项最近更新人。 |
| modified_time | String | **参数解释**： 工作项最近更新时间，unix时间戳，单位：毫秒。 **取值范围**： 不涉及。 |
| plan_end_date | String | **参数解释**： 工作项计划结束日期，unix时间戳，单位：毫秒。 **取值范围**： 不涉及。 |
| close_time | String | **参数解释**： 工作项关闭时间，unix时间戳，单位：毫秒。 **取值范围**： 不涉及。 |
| workload | String | **参数解释**： 工作项计划工时。 **取值范围**： 0\~999999999.9。 |
| workload_sum | String | **参数解释**： 工作项实际工时。 **取值范围**： 0\~999999999.9。 |
| tenant_id | String | **参数解释**： 工作项所属租户ID，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**tenant_id**字段的值就是工作项所属租户ID。 **取值范围**： 32个字符。 |
| link | String | **参数解释**： 工作项关联项ID。 **取值范围**： 0\~2048个字符。 |
| suspended | Boolean | **参数解释**： 工作项是否已挂起。 **取值范围**： - true：表示已挂起 - false：表示未挂起 |
| status_modified_time | String | **参数解释**： 工作项状态改变时间，可用于计算工作项在当前状态停留天数，unix时间戳，单位：毫秒。 **取值范围**： 不涉及。 |
| labels | Array of [LabelEntity] objects | **参数解释**： 工作项标签。数组元素为LabelEntity对象。 **取值范围**： 不涉及。 |
| custom_fields | Array of [FieldCodeValuePair] objects | **参数解释**： 工作项自定义字段映射，用户添加的系统字段也在此列，格式为{"code":"字段code","value":"字段值"}。数组元素为FieldCodeValuePair对象。 **取值范围**： 不涉及。 |
| children | Array of [IssueEntity] objects | **参数解释**： 工作项的子工作项集合。数组元素为IssueEntity对象。 **取值范围**： 不涉及。 |
| path | String | **参数解释**： 子工作项的路径。 **取值范围**： 0\~256个字符。 |
| ir2feature | String | **参数解释**： IR和SF的关联字段。 **取值范围**： 不涉及。 |
| need_break | String | **参数解释**： 工作项是否需要分解。 **取值范围**： - yes：需要分解 - no：不需要分解 |
| break_status | String | **参数解释**： 分解状态。 **取值范围**： - decomposed：已分解 - undecomposed：未分解 - 置空：不涉及 |
| baseline | String | **参数解释**： 工作项基线状态。 **取值范围**： - null：未基线 - baselined：已基线 - baseline-reviewing：基线评审中 |
| priority | String | **参数解释**： 工作项优先级，部分工作项有此字段。 **取值范围**： - 低：低优先级。 - 中：中优先级。 - 高：高优先级。 |
| related_network_security | String | **参数解释**： 是否涉及网络安全。 **取值范围**： - yes：涉及网络安全。 - no：不涉及网络安全。 |
| collaboratives | String | **参数解释**： 研发需求协同信息，协同任务ID，可通过[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**collaboratives**字段的值就是研发需求协同信息，协同任务ID。 **取值范围**： 0\~256个字符。 |
| business_domain | String | **参数解释**： 领域字段。 **取值范围**： - software - soft-hardware - hardware - 性能 - 功能 - 运维 - 运营 - 用户体验 - 隐私保护 - 合规 - 韧性(可靠性/可用性) - 韧性(危险检测与相应恢复) - 透明 - 无害 - 安全 - API - 成本 - 可维护性 - 其他DFX - 可用性 - others |
| plan_pi | String | **参数解释**： 工作项发布计划ID。通过[发布/迭代计划列表查询](https://support.huaweicloud.com/api-projectman/ListPlan.html)接口查询计划列表，返回参数中PlanVO里面的category=PI的对象的**id**字段就是迭代计划的ID。 **取值范围**： 18\~19个字符的数字字符串。 |
| plan_iteration | String | **参数解释**： 工作项完成的迭代计划ID，在Bug中为修复迭代计划ID。通过[发布/迭代计划列表查询](https://support.huaweicloud.com/api-projectman/ListPlan.html)接口查询计划列表，返回参数中PlanVO里面的category=Iteration的对象的**id**字段就是迭代计划的ID。 **取值范围**： 18\~19个字符的数字字符串。 |
| change_status | String | **参数解释**： 工作项变更状态。 **取值范围**： - change-reviewing：变更评审中 - changed：已变更 - unchange：未变更 - null：未变更 |
| no_break_reason | String | **参数解释**： 无需分解原因。 **取值范围**： 0\~512个字符。 |
| submitted_by | Array of [UserEntity] objects | **参数解释**： 工作项提出人。数组元素为UserEntity对象。 **取值范围**： 不涉及。 |
| ir2rr | String | **参数解释**： IR关联的RR ID，可以通过[查询工作项列表](https://support.huaweicloud.com/api-projectman/ListIpdProjectIssues.html)或者[查询树状工作项](https://support.huaweicloud.com/api-projectman/ShowIpdIssueTree.html)接口获取，响应消息体中的**id**字段的值就是工作项ID。 **取值范围**： 0\~1024个字符。 |
| feature_set | String | **参数解释**： 特性集ID，可以通过[查询特性集](https://support.huaweicloud.com/api-projectman/ShowBaselineSnapshots.html)接口获取，响应消息体中的**id**字段的值就是特性集ID。 **取值范围**： 18\~19个字符的数字字符串。 |
| expected_repair_date | String | **参数解释**： 期望修复时间。预设字段中，仅Bug有此字段，unix时间戳，单位：毫秒。 **取值范围**： 11\~19个字符。 |
| found_pi | String | **参数解释**： 缺陷发现发布计划ID，预设字段中，仅Bug有此字段。通过[发布/迭代计划列表查询](https://support.huaweicloud.com/api-projectman/ListPlan.html)接口查询计划列表，返回参数中PlanVO里面的category=PI的对象的**id**字段就是迭代计划的ID。 **取值范围**： 18\~19个字符的数字字符串。 |
| found_iteration | String | **参数解释**： 缺陷发现迭代计划ID，预设字段中，仅Bug有此字段。通过[发布/迭代计划列表查询](https://support.huaweicloud.com/api-projectman/ListPlan.html)接口查询计划列表，返回参数中PlanVO里面的category=Iteration的对象的**id**字段就是迭代计划的ID。 **取值范围**： 18\~19个字符的数字字符串。 |
| reason_analysis | String | **参数解释**： 分析原因。 **取值范围**： 0\~50000个字符。 |
| repair_solution | String | **参数解释**： 修复方案。预设字段中，仅Bug有此字段。 **取值范围**： 0\~50000个字符。 |
| test_report | String | **参数解释**： 测试报告。预设字段中，仅Bug有此字段。 **取值范围**： 0\~50000个字符。 |
| sys_no_repair_reason | String | **参数解释**： 无需修复原因。预设字段中，仅Bug有此字段。 **取值范围**： 0\~50000个字符。 |
| sys_activation_reason | String | **参数解释**： 激活原因。预设字段中，仅Bug有此字段。 **取值范围**： 0\~50000个字符。 |
| sys_return_reason | String | **参数解释**： 退回原因。预设字段中，仅Bug有此字段。 **取值范围**： 0\~50000个字符。 |
| test_failures_times | Integer | **参数解释**： 回归不通过次数。预设字段中，仅Bug有此字段。 **取值范围**： 0\~999999。 |
| close_type | String | **参数解释**： 关闭类型。 **取值范围**： - problem_solved：问题解决关闭 - problem_to_requirement：问题转需求关闭 - duplicate_problem：重复问题关闭 - not_a_problem：非问题关闭 |
| plan_owner | [UserEntity] object | **参数解释**： 工作项规划责任人。负责工作项的规划和计划制定。 |
| doing_owner | [UserEntity] object | **参数解释**： 工作项实现责任人。负责工作项的具体实现和执行。 |
| delivered_owner | [UserEntity] object | **参数解释**： 工作项交付责任人。负责工作项的交付和发布。 |
| checking_owner | [UserEntity] object | **参数解释**： 工作项验收责任人。负责工作项的最终验收确认。 |
| test_owner | [UserEntity] object | **参数解释**： 工作项测试责任人。负责工作项的测试验证。 |
| develop_owner | [UserEntity] object | **参数解释**： 工作项开发责任人。负责工作项的开发实现。 |
| processing_owner | [UserEntity] object | **参数解释**： 工作项处理中责任人。负责工作项的当前处理阶段。 |
| fixed_owner | [UserEntity] object | **参数解释**： 工作项修复责任人。负责工作项的问题修复。 |
| researchanddevelop_owner | [UserEntity] object | **参数解释**： 工作项研发责任人。负责工作项的研发工作。 |
| analyse_owner | [UserEntity] object | **参数解释**： 工作项分析责任人。负责工作项的需求分析和技术分析。 |
| plan_start_date | String | **参数解释**： 计划开始时间。工作项的计划启动日期，用于项目进度管理和排期。 **取值范围**： 11\~19个字符的时间戳字符串，单位为毫秒（ms）。 |
| expect_delivery_time | String | **参数解释**： 期望完成时间。工作项的预期交付日期，用于跟踪工作项是否按期完成。 **取值范围**： 11\~19个字符的时间戳字符串，单位为毫秒（ms）。 |
| plan_test_end_date | String | **参数解释**： 计划测试结束时间。Bug类型工作项的计划测试完成日期，用于跟踪Bug修复后的测试进度。 **取值范围**： 11\~19个字符的时间戳字符串，单位为毫秒（ms）。 |
| severity | String | **参数解释**： 严重程度。Bug类型工作项的严重级别，用于评估Bug的影响范围和修复优先级。 **取值范围**： - 致命：系统崩溃、数据丢失等严重影响 - 严重：主要功能无法使用 - 一般：次要功能异常，有替代方案 - 提示：界面优化、建议性问题 |
| promised | String | **参数解释**： 是否承诺。RR（原始需求）类型工作项的承诺状态标识，用于标记需求是否已承诺交付。 **取值范围**： - yes：已承诺 - no：未承诺 |
| recipient | Array of [UserEntity] objects | **参数解释**： 承接人。RR（原始需求）类型工作项的需求承接责任人，负责需求的分析和转化。 **取值范围**： 不涉及。 |
| sys_no_develop_reason | String | **参数解释**： 无需研发原因。RR（原始需求）类型工作项不需要进行研发的原因说明。 **取值范围**： 0\~50000个字符。 |
| val_feature | String | **参数解释**： 价值特性。SF/FE类型工作项对应的业务价值特性描述，用于关联业务价值和技术实现。 **取值范围**： - yes：是 - no：否 |
| function_scene | String | **参数解释**： 功能场景。SF/FE类型工作项的功能应用场景描述，用于说明特性的使用场景和用户故事。 **取值范围**： 0\~512个字符。 |
表11LabelEntity
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| id | String | **参数解释**： 标签ID，可通过[查询标签列表](https://support.huaweicloud.com/api-projectman/ListIpdLabels.html)接口获取，响应消息体中的**id**字段的值就是标签ID。 **取值范围**： 18\~19个字符的数字字符串。 |
| category_types | Array of strings | **参数解释**： 标签所属工作项类型编码。 |
| label_type | String | **参数解释**： 标签所属工作项类型，对应工作项的type字段，枚举类型。 **取值范围**： - raw requirement：原始需求 - feature：系统特性 - requirement：研发需求 - task：任务 - bug：缺陷 |
| color | String | **参数解释**： 标签颜色RGB。 **取值范围**： 可选颜色代码与对应中文描述如下： - #86CAFF：浅蓝色 - #6DDEBB：青绿色 - #A6DD82：黄绿色 - #FAC20A：金黄色 - #FA9841：橙色 - #F66F6A：珊瑚红 - #F3689A：粉红色 - #A97AF8：淡紫色 - #71757F：中性灰 - #5E7CE0：宝蓝色 - #207AB3：深蓝色 - #169E6C：翠绿色 - #6CA83B：草绿色 - #B58200：棕黄色 - #B54E04：赭石色 - #B02121：朱红色 - #AD215B：玫红色 - #572DB3：深紫色 - #4F4F4F：深灰色 - #3C51A6：靛蓝色 |
| title | String | **参数解释**： 标签标题。 **取值范围**： 不涉及。 |
表12FieldCodeValuePair
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| code | String | **参数解释**： 工作项自定义字段code值。可选值可以通过[查询字段模板列表](https://support.huaweicloud.com/api-projectman/ListIssueFields.html)接口获取，响应体中的**code**就是字段唯一标识。 **取值范围**： 不涉及。 |
| value | String | **参数解释**： 工作项自定义字段值。 **取值范围**： 不涉及。 |
表13UserEntity
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| id | String | **参数解释**： 用户ID，可通过[查询项目成员列表](https://support.huaweicloud.com/api-projectman/ListProjectUsers.html)接口获取，响应消息体中的**id**字段的值就是用户ID。 **取值范围**： 不涉及。 |
| name | String | **参数解释**： 用户名称。 **取值范围**： 2\~64个字符。 |
| nick_name | String | **参数解释**： 用户昵称。 **取值范围**： 2\~30个字符。 |
**状态码：400**
表14响应Body参数
| 参数 | 参数类型 | 描述 |
|:---|:---|:---|
| error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。 |
| error_msg | String | **参数解释**： 错误描述，对error_code的补充解释。 **取值范围**： 不涉及。 |
#### 请求示例
批量创建研发需求
```
POST https://{endpoint}/v2/ipdprojectservice/projects/8e70d806a8f04d018ea6af6b6ffe7b96/issues/batch
[ {
"ir2rr" : "956559072707911681",
"category" : "IR",
"category_layer_id" : "10002",
"submitted_by" : [ {
"id" : "a360371833bf4c558f796fd707b44daf"
}, {
"id" : "a360371833bf4c558f796fd707b44dwf"
} ],
"description" : "【需求背景】
【需求价值】
【需求详情】
",
"title" : "IR-18-分解",
"assignee" : {
"id" : "a360371833bf4c558f796fd707b44daf"
},
"priority" : "中",
"plan_pi" : "1273201979687350273",
"plan_end_date" : "1706630400000",
"business_domain" : "software",
"assigned_cc" : [ {
"id" : "a360371833bf4c558f796fd707b44daf"
} ],
"custom_fields" : [ {
"code" : "done_ratio",
"value" : ""
}, {
"code" : "c7073388365101674496",
"value" : "881467547473321986"
}, {
"code" : "c7148504958125613056",
"value" : ""
}, {
"code" : "module",
"value" : ""
}, {
"code" : "c7148512434669625344",
"value" : "956591616891461634"
} ]
} ]
```
#### 响应示例
**状态码：200**
OK
```
{
"status" : "success",
"result" : [ {
"category" : "IR",
"id" : "974703074900615168",
"title" : "IR-18-分解",
"description" : "【需求背景】
【需求价值】
【需求详情】
",
"type" : "requirement",
"number" : "IR20240313680650",
"project_id" : "8e70d806a8f04d018ea6af6b6ffe7b96",
"status" : "Start",
"state" : "正在工作",
"assignee" : {
"id" : "a360371833bf4c558f796fd707b44daf",
"name" : "devcloud_devcloud_01",
"nick_name" : "测试账号123"
},
"assigned_cc" : [ {
"id" : "a360371833bf4c558f796fd707b44daf",
"name" : "devcloud_devcloud_01",
"nick_name" : "测试账号123"
} ],
"created_by" : {
"id" : "a360371833bf4c558f796fd707b44daf",
"name" : "devcloud_devcloud_01",
"nick_name" : "测试账号123"
},
"created_time" : "1710316922000",
"modified_by" : {
"id" : "a360371833bf4c558f796fd707b44daf",
"name" : "devcloud_devcloud_01",
"nick_name" : "测试账号123"
},
"modified_time" : "1710316922000",
"workload" : "20.0",
"tenant_id" : "4e919d73499648e3b0292cd3cbef806a",
"status_modified_time" : "1710316922000",
"custom_fields" : [ {
"code" : "c7073388365101674496",
"value" : "881467547473321986"
}, {
"code" : "c7148512434669625344",
"value" : "956591616891461634"
} ],
"need_break" : "yes",
"break_status" : "undecomposed",
"priority" : "中",
"related_network_security" : "no",
"business_domain" : "software",
"plan_pi" : "",
"no_break_reason" : "",
"submitted_by" : [ {
"id" : "a360371833bf4c558f796fd707b44daf",
"name" : "devcloud_devcloud_01",
"nick_name" : "测试账号123"
}, null ],
"ir2rr" : "956559072707911681"
} ]
}
```
**状态码：400**
请求失败的响应。例如无操作权限、项目不存在。
```
{
"error_code" : "PM.02174103",
"error_msg" : "无操作权限"
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
| 400 | 请求失败的响应。例如无操作权限、项目不存在。 |
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。