# 批量更新工作项 - BatchUpdateIssues #### 功能介绍 批量更新工作项。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-projectman/projectman_03_Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | codeartsreq:workitem:update | Write | - | - codeartsreq:Model - codeartsreq:ProjectId | - | - | #### URI PUT /v2/projects/{project_id}/issues/batch-update 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目的32位UUID，项目唯一标识，通过[查询项目列表接口](https://support.huaweicloud.com/api-projectman/ListProjectsV4.html)获取，响应消息体中的**project_id**字段的值就是项目ID。 **约束限制**： 32个字符，由英文字母和数字组成。 **取值范围：** 不涉及。 **默认取值**： 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | move | 否 | Boolean | **参数解释：** 用于控制是否在批量更新问题时执行移动操作。如果请求中没有提供move 参数，其默认值为 false。 **取值范围：** true：移动。 false：不移动。 **默认取值：** false。 | | OperateType | 是 | String | **参数解释：** 用于指定操作类型，例如import、export等。如果请求中没有提供 operate_type 参数，该参数将为 null。 **约束限制：** 32个字符，由英文字母和数字组成。 **取值范围：** 不涉及。 **默认取值：** null。 | | Domain-Id | 否 | String | **参数解释：** 租户ID，通过获取当前用户信息接口查询用户对应的租户信息。 **约束限制：** 32个字符，由英文字母和数字组成。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | category | 否 | String | **参数解释：** 工作项类型，如RR、FE、IR、TASK。 **约束限制：** **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | IsPlan | 否 | Boolean | **参数解释：** 是否为"计划"问题。 **约束限制：** 不涉及。 **取值范围：** true：计划内问题。 false：不是计划问题。 **默认取值：** false。 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 不涉及。 **取值范围：** 长度为10\~32768个字符。 **默认取值：** 不涉及。 | 表4请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | - | 否 | Object | 请求参数 | #### 响应参数 **状态码：200** 无 **状态码：400** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 错误描述。 **取值范围**： 不涉及。 | **状态码：401** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 错误描述。 **取值范围**： 不涉及。 | | request_id | String | **参数解释**： 请求的ID，系统自动生成。 **取值范围**： 不涉及。 | #### 请求示例 ``` PUT https://{endpoint}/v2/projects/5740964bd1164d569bf40258eb343726/issues/batch-update { "id" : [ "1135270157030600704", "1135269726766313472", "1113411113095049216" ], "attribute" : { "priority" : "高" } } ``` #### 响应示例 **状态码：200** ``` { "status" : "success", "message" : null, "result" : [ { "success" : [ { "modified_by" : "a360371833bf4c558f796fd707b44daf", "operation_id" : "49a61374-0df5-42d4-94aa-2ddd0ed98fff", "id" : "1113411113095049216", "priority" : "高", "modified_date" : "1752722645053" }, { "modified_by" : "a360371833bf4c558f796fd707b44daf", "operation_id" : "5261db89-4b4d-4ed0-986f-c861bf94e2ed", "id" : "1135269726766313472", "priority" : "高", "modified_date" : "1752722645171" }, { "modified_by" : "a360371833bf4c558f796fd707b44daf", "operation_id" : "2324c0d3-a377-48f7-b869-558f12bda613", "id" : "1135270157030600704", "priority" : "高", "modified_date" : "1752722645275" } ], "failed" : [ ], "success_num" : 3, "fail_num" : 0, "cr_plan_issues" : [ ], "cr_update_issues" : [ ] } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK。 | | 400 | 非法请求。 | | 401 | 客户端所提供的认证信息不正确或非法。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。