文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试用例管理/ V5批量更新测试用例 - V4BatchUpdateTestcases_copy
更新时间:2026-07-07 GMT+08:00
分享

V5批量更新测试用例 - V4BatchUpdateTestcases_copy

功能介绍

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

调用方法

请参见如何调用API

URI

PUT /GT3KServer/v4/{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参数

参数

参数类型

描述

value

UpdateTestCaseListVo object

参数解释

请求返回的数据

取值范围

不涉及

表4 UpdateTestCaseListVo

参数

参数类型

描述

id

String

参数解释

CTS需要返回资源id

取值范围

不涉及

name

String

参数解释

CTS需要返回资源name

取值范围

不涉及

success_list

Array of strings

参数解释

成功批量更新用例的id列表

取值范围

不涉及

failed_list

Array of strings

参数解释

没有批量更新用例的id列表

取值范围

不涉及

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:500

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

请求示例

V4批量更新测试用例

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

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

响应示例

状态码:200

OK

{
  "value" : {
    "id" : "000004de0c354920b6f7a8f2319a5469",
    "name" : "用例1 ",
    "success_list" : [ "000004de0c354920b6f7a8f2319a5469" ],
    "failed_list" : [ "00000d98db654d779fb90fc88f12902e" ]
  }
}

状态码: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

错误码

请参见错误码

相关文档