批量更新工作项
功能介绍
批量更新工作项。
调用方法
请参见如何调用API。
URI
PUT /v2/projects/{project_id}/issues/batch-update
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释： 项目的32位uuid，项目唯一标识，通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID。 约束限制： 正则表达式，[A-Za-z0-9]{32}。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
move |
否 |
Boolean |
参数解释： 用于控制是否在批量更新问题时执行移动操作。如果请求中没有提供move 参数，其默认值为 false。 取值范围： ture：移动。 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。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释： 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制： 必传。 取值范围： 最小长度：10，最大长度：32768。 默认取值： 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
- |
否 |
Object |
请求参数 |
响应参数
状态码：200
OK。
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误描述 |
状态码：401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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" : [ ]
} ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK。 |
|
400 |
非法请求。 |
|
401 |
客户端所提供的认证信息不正确或非法。 |
错误码
请参见错误码。
