批量更新工作项 - BatchUpdateIssues

功能介绍

批量更新工作项。

调用方法

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
codeartsreq:workitem:update	Write	-	codeartsreq:Model codeartsreq:ProjectId	-	-

URI

PUT /v2/projects/{project_id}/issues/batch-update

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目的32位uuid，项目唯一标识，通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID。约束限制：正则表达式，[A-Za-z0-9]{32}。取值范围：不涉及。默认取值：不涉及。

表2 Query参数
参数	是否必选	参数类型	描述
move	否	Boolean	参数解释：用于控制是否在批量更新问题时执行移动操作。如果请求中没有提供move 参数，其默认值为 false。取值范围： true：移动。 false：不移动。默认取值： false。
OperateType	是	String	参数解释：用于指定操作类型，例如import、export等。如果请求中没有提供 operate_type 参数，该参数将为 null。约束限制：正则表达式，[A-Za-z0-9]{32}。取值范围：不涉及。默认取值： null。
Domain-Id	否	String	参数解释：租户ID，通过获取当前用户信息接口查询用户对应的租户信息。约束限制：正则表达式，[A-Za-z0-9]{32}。取值范围：不涉及默认取值：不涉及
category	否	String	参数解释：工作项类型，如RR、FE、IR、TASK。约束限制：取值范围：不涉及。默认取值：不涉及。
IsPlan	否	Boolean	参数解释：是否为“计划”问题。约束限制：不涉及。取值范围： true：计划内问题。 false：不是计划问题。默认取值： false。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：必传。取值范围：最小长度：10，最大长度：32768。默认取值：不涉及。

表4 请求Body参数
参数	是否必选	参数类型	描述
-	否	Object	请求参数

响应参数

状态码：200

OK。

状态码：400

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

状态码：401

表6 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：不涉及。
error_msg	String	参数解释：错误描述。取值范围：不涉及。

请求示例

PUT http://{endpoint}/v2/projects/5740964bd1164d569bf40258eb343726/issues/batch-update

{
  "id" : [ "1135270157030600704", "1135269726766313472", "1113411113095049216" ],
  "attribute" : {
    "priority" : "高"
  }
}

响应示例

状态码：200

OK。

{
  "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" : [ ]
  } ]
}