文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试用例管理/ V5批量更新测试用例 - V5BatchUpdateTestcases
更新时间：2026-06-12 GMT+08:00
在线调试
CLI示例
查看PDF
分享

V5批量更新测试用例 - V5BatchUpdateTestcases

功能介绍

此接口用于V5版本批量更新测试用例

调用方法

请参见如何调用API。

URI

PUT /v5/{project_id}/testcases/batch-update

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

testcase_uris

否

Array of strings

需要批量更新的测试用例URI列表

update_fields

否

Object

需要更新的字段内容

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

total

Integer

起始记录数 大于 实际总条数时，值为0，分页请求才有此值

value

String

实际的数据类型：单个对象，集合 或 NULL

reason

String

业务失败的提示内容

page_size

Integer

分页大小

page_no

Integer

分页编码

has_more

Boolean

是否有更多

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码：500

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

请求示例

V5批量更新测试用例

PUT https://{endpoint}/v5/{project_id}/testcases/batch-update

{
  "testcase_uris" : [ "tc-001" ],
  "fields" : {
    "name" : "更新后的用例"
  }
}

响应示例

状态码：200

OK

{
  "value" : "批量更新成功",
  "reason" : ""
}

状态码：400

Bad Request

{
  "error_code" : "CLOUDTEST.00000001",
  "error_msg" : "返回的错误信息"
}

状态码：500

Internal Server Error

{
  "error_code" : "CLOUDTEST.00000001",
  "error_msg" : "返回的错误信息"
}

状态码

状态码

描述

200

OK

400

Bad Request

500

Internal Server Error

错误码

请参见错误码。

父主题： 测试用例管理

相关文档