文档首页/测试计划 CodeArts TestPlan/API参考/API/自定义测试服务用例管理/批量更新用例属性 - BatchUpdateVersionTestCasesV4

更新时间：2025-12-27 GMT+08:00

批量更新用例属性 - BatchUpdateVersionTestCasesV4

功能介绍

批量更新用例属性

调用方法

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 约束限制: 不涉及取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字默认取值: 不涉及

请求参数

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

表3 请求Body参数
参数	是否必选	参数类型	描述
steps	否	Array of TestCaseStepInfo objects	参数解释测试步骤约束限制不涉及取值范围不涉及默认取值不涉及
attachments	否	Array of TestCaseAttachmentInfo objects	参数解释附件约束限制不涉及取值范围不涉及默认取值不涉及
author	否	String	参数解释创建人约束限制不涉及取值范围不涉及默认取值不涉及
name	否	String	参数解释名称约束限制不涉及取值范围不涉及默认取值不涉及
rank	否	Integer	参数解释用例等级约束限制不涉及取值范围不涉及默认取值不涉及
owner	否	String	参数解释处理人约束限制不涉及取值范围不涉及默认取值不涉及
preparation	否	String	参数解释前置条件约束限制不涉及取值范围不涉及默认取值不涉及
remark	否	String	参数解释备注约束限制不涉及取值范围不涉及默认取值不涉及
stage	否	String	参数解释测试阶段约束限制不涉及取值范围不涉及默认取值不涉及
activity	否	String	参数解释测试类型约束限制不涉及取值范围不涉及默认取值不涉及
keywords	否	String	参数解释关键词约束限制不涉及取值范围不涉及默认取值不涉及
market	否	String	参数解释 apitest标记是否代码已提交约束限制不涉及取值范围不涉及默认取值不涉及
designer	否	String	参数解释设计者约束限制不涉及取值范围不涉及默认取值不涉及
tags	否	String	参数解释标签约束限制不涉及取值范围不涉及默认取值不涉及
region	否	String	参数解释逻辑region，外部使用公有云实际区域，内部使用默认值约束限制不涉及取值范围不涉及默认取值不涉及
relate_type	否	String	参数解释: 关联资源类型约束限制: 不涉及取值范围: bug，缺陷。 requirement，需求。默认取值: 不涉及
service_type	否	Integer	参数解释: 服务类型约束限制: 不涉及取值范围: -1，全量用例。 0，手工测试。 1，接口自动化。 7，功能自动化。 8，WebUI自动化。 100，自定义自动化(工厂)。 11，性能自动化。默认取值: 不涉及
only_change_script	否	String	参数解释更新接口用例的java脚本路径标识约束限制不涉及取值范围不涉及默认取值不涉及
add_to_iterator	否	String	参数解释需求添加到迭代标识约束限制不涉及取值范围不涉及默认取值不涉及
need_update_relation	否	String	参数解释是否修改关联关系约束限制不涉及取值范围 true:是 false:否默认取值不涉及
creation_version_uri	否	String	参数解释创建版本Uri 约束限制不涉及取值范围不涉及默认取值不涉及
number	否	String	参数解释用例编号约束限制不涉及取值范围不涉及默认取值不涉及
case_type	否	Integer	参数解释: 用例类型约束限制: 不涉及取值范围: 0，手工测试。 1，接口自动化。 2，性能用例。默认取值: 不涉及
platform_type	否	Integer	参数解释执行平台类型约束限制不涉及取值范围不涉及默认取值不涉及
test_type	否	Integer	参数解释: 测试类型约束限制: 不涉及取值范围: 1，功能性测试。 2，兼容性测试。 4，性能测试。 15，易用性测试。 22，可靠性测试。 14，安全性测试。 21，可服务性测试。默认取值: 不涉及
design_note	否	String	参数解释设计描述约束限制不涉及取值范围不涉及默认取值不涉及
test_step	否	String	参数解释测试步骤约束限制不涉及取值范围不涉及默认取值不涉及
expect_output	否	String	参数解释期望结果约束限制不涉及取值范围不涉及默认取值不涉及
env_type	否	String	参数解释测试环境类型约束限制不涉及取值范围不涉及默认取值不涉及
exe_platform	否	String	参数解释执行平台约束限制不涉及取值范围不涉及默认取值不涉及
testcase_project	否	String	参数解释测试工程约束限制不涉及取值范围不涉及默认取值不涉及
svn_script_path	否	String	参数解释脚本路径约束限制不涉及取值范围不涉及默认取值不涉及
map_restrict	否	String	参数解释约束条件约束限制不涉及取值范围不涉及默认取值不涉及
network_script_name	否	String	参数解释网络脚本名约束限制不涉及取值范围不涉及默认取值不涉及
auto_type	否	Integer	参数解释自动化类型，约束限制不涉及取值范围非自动化:0, 是自动化:1 默认取值不涉及
to_be_auto_exec	否	Integer	参数解释被自动化执行约束限制不涉及取值范围不涉及默认取值不涉及
last_result	否	String	参数解释最后一次结果约束限制不涉及取值范围不涉及默认取值不涉及
last_result_uri	否	String	参数解释最后一次结果Uri 约束限制不涉及取值范围不涉及默认取值不涉及
feature_uri	否	String	参数解释目录Uri 约束限制不涉及取值范围不涉及默认取值不涉及
interface_name	否	String	参数解释测试接口名约束限制不涉及取值范围不涉及默认取值不涉及
snp_no	否	String	参数解释网络问题ID 约束限制不涉及取值范围不涉及默认取值不涉及
dr_relation_id	否	String	参数解释关联需求编号约束限制不涉及取值范围不涉及默认取值不涉及
test_base_num	否	String	参数解释测试基数约束限制不涉及取值范围不涉及默认取值不涉及
automatically_executed	否	Integer	参数解释是否被自动化执行约束限制不涉及取值范围不涉及默认取值不涉及
first_execute_time	否	String	参数解释第一次执行时间约束限制不涉及取值范围不涉及默认取值不涉及
detect_type	否	String	参数解释检测类型约束限制不涉及取值范围不涉及默认取值不涉及
execute_param	否	String	参数解释执行参数约束限制不涉及取值范围不涉及默认取值不涉及
test_feature	否	String	参数解释分析领域约束限制不涉及取值范围不涉及默认取值不涉及
is_contract_testcase	否	Integer	参数解释是否是契约用例约束限制不涉及取值范围 0:表示非契约用例, 1：表示契约用例默认取值不涉及
time_cost	否	Double	参数解释总共耗时约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_1	否	String	参数解释自定义字段1 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_2	否	String	参数解释自定义字段2 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_3	否	String	参数解释自定义字段3 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_4	否	String	参数解释自定义字段4 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_5	否	String	参数解释自定义字段5 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_6	否	String	参数解释自定义字段6 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_7	否	String	参数解释自定义字段7 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_8	否	String	参数解释自定义字段8 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_9	否	String	参数解释自定义字段9 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_10	否	String	参数解释自定义字段10 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_11	否	String	参数解释自定义字段11 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_12	否	String	参数解释自定义字段12 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_13	否	String	参数解释自定义字段13 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_14	否	String	参数解释自定义字段14 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_15	否	String	参数解释自定义字段15 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_16	否	String	参数解释自定义字段16 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_17	否	String	参数解释自定义字段17 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_18	否	String	参数解释自定义字段18 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_19	否	String	参数解释自定义字段19 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_20	否	String	参数解释自定义字段20 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_21	否	String	参数解释自定义字段21 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_22	否	String	参数解释自定义字段22 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_23	否	String	参数解释自定义字段23 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_24	否	String	参数解释自定义字段24 约束限制不涉及取值范围不涉及默认取值不涉及
custom_field_25	否	String	参数解释自定义字段25 约束限制不涉及取值范围不涉及默认取值不涉及
be_auto_type_time	否	String	参数解释记录用例由非自动化变为自动化类型的时间约束限制不涉及取值范围不涉及默认取值不涉及
compare_number	否	String	参数解释配对用例编号约束限制不涉及取值范围不涉及默认取值不涉及
scene_flag	否	String	参数解释场景标识约束限制不涉及取值范围不涉及默认取值不涉及
base_flag	否	String	参数解释场景标识约束限制不涉及取值范围不涉及默认取值不涉及
para_validator	否	String	参数解释区别是否从yaml中生成的用例约束限制不涉及取值范围 true:是 false:否默认取值默认false
knet_node_id	否	String	参数解释 knet节点id 约束限制不涉及取值范围不涉及默认取值不涉及
last_exe_author	否	String	参数解释最后一次执行用户约束限制不涉及取值范围不涉及默认取值不涉及
cloud_carrier	否	String	参数解释运营商约束限制不涉及取值范围不涉及默认取值不涉及
market_place	否	String	参数解释应用市场约束限制不涉及取值范围不涉及默认取值不涉及
test_mind_id	否	String	参数解释脑图id 约束限制不涉及取值范围不涉及默认取值不涉及
test_mind_url	否	String	参数解释脑图url 约束限制不涉及取值范围不涉及默认取值不涉及
commit_url	否	String	参数解释 git提交url 约束限制不涉及取值范围不涉及默认取值不涉及
test_pattern_number	否	String	参数解释测试模式编号约束限制不涉及取值范围不涉及默认取值不涉及
test_factor_number	否	String	参数解释测试因子编号约束限制不涉及取值范围不涉及默认取值不涉及
status_code	否	String	参数解释状态Code 约束限制不涉及取值范围不涉及默认取值不涉及
result_code	否	String	参数解释结果Code 约束限制不涉及取值范围不涉及默认取值不涉及
release_id	否	String	参数解释迭代ID 约束限制不涉及取值范围不涉及默认取值不涉及
label_id	否	String	参数解释标签ID 约束限制不涉及取值范围不涉及默认取值不涉及
label_names	否	Array of strings	参数解释用例操作时，标签名列表约束限制不涉及取值范围不涉及默认取值不涉及
module_id	否	String	参数解释模块ID 约束限制不涉及取值范围不涉及默认取值不涉及
execute_latest_time	否	String	参数解释最后执行时间约束限制不涉及取值范围不涉及默认取值不涉及
execute_duration	否	String	参数解释执行时长约束限制不涉及取值范围不涉及默认取值不涉及
is_keyword	否	Integer	参数解释是否关键用例约束限制不涉及取值范围不涉及默认取值不涉及
release_dev	否	String	参数解释测试版本号约束限制不涉及取值范围不涉及默认取值不涉及
new_created	否	Integer	参数解释是否用户新增用例约束限制不涉及取值范围不涉及默认取值不涉及
execute_parameter	否	String	参数解释执行参数约束限制不涉及取值范围不涉及默认取值不涉及
project_uuid	否	String	参数解释项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 约束限制不涉及取值范围不涉及默认取值不涉及
version_uri	否	String	参数解释分支或者迭代uri 约束限制不涉及取值范围不涉及默认取值不涉及
case_list	否	Array of CaseInfo objects	参数解释更新用例信息列表约束限制不超过50个取值范围不超过50个默认取值不涉及
case_id_list	否	Array of strings	参数解释批量更新用例id列表约束限制不超过50个取值范围不超过50个默认取值不涉及
label_operation	否	LabelOperation object	参数解释标签操作信息,用于批量对用例设置标签约束限制不涉及取值范围不涉及默认取值不涉及

表4 TestCaseStepInfo
参数	是否必选	参数类型	描述
test_step	否	String	参数解释测试步骤约束限制不涉及取值范围不涉及默认取值不涉及
expect_result	否	String	参数解释预期结果约束限制不涉及取值范围不涉及默认取值不涉及
step_actual	否	String	参数解释步骤的实际结果约束限制不涉及取值范围不涉及默认取值不涉及
step_result	否	String	参数解释步骤结果约束限制不涉及取值范围不涉及默认取值不涉及

表5 TestCaseAttachmentInfo
参数	是否必选	参数类型	描述
override	否	Boolean	参数解释附件是否要被覆盖约束限制不涉及取值范围 true\|false 默认取值不涉及
doc_id	否	String	参数解释文档id 约束限制不涉及取值范围不涉及默认取值不涉及
file_name	是	String	参数解释文件名约束限制不涉及取值范围不涉及默认取值不涉及
file_path	否	String	参数解释文件路径约束限制不涉及取值范围不涉及默认取值不涉及
file_type	否	String	参数解释: 文件类型约束限制: 根据文件后缀扩展名填入取值范围: txt，文本文件。 img，图片文件。等等默认取值: 不涉及
file_size	否	String	参数解释文件大小约束限制不涉及取值范围不涉及默认取值不涉及
override_id	否	String	参数解释重复用例ID 约束限制不涉及取值范围不涉及默认取值不涉及
related_type	否	String	参数解释: 相关类型约束限制: 不涉及取值范围: 0，本地上传。 1，关联文档。默认取值: 不涉及
store_file_name	否	String	参数解释保存文件名约束限制不涉及取值范围不涉及默认取值不涉及
system_type	否	String	参数解释: 系统类型约束限制: 根据系统类型传入对应的值取值范围: docman，docman系统。 testman，testman系统。默认取值: 不涉及
storage_system	否	String	参数解释区分文件存储系统约束限制不涉及取值范围不涉及默认取值不涉及

表6 CaseInfo
参数	是否必选	参数类型	描述
case_id	否	String	参数解释用例id 约束限制不涉及取值范围不涉及默认取值不涉及
script_url	否	String	参数解释脚本路径约束限制不涉及取值范围不涉及默认取值不涉及

表7 LabelOperation
参数	是否必选	参数类型	描述
op_type	否	String	参数解释操作类型约束限制不涉及取值范围 update/delete 默认取值不涉及
labels	否	Array of strings	参数解释标签数组约束限制不涉及取值范围不涉及默认取值不涉及

响应参数

状态码：200

表8 响应Body参数
参数	参数类型	描述
value	UpdateTestCaseListVo object	参数解释请求返回的数据取值范围不涉及

表9 UpdateTestCaseListVo
参数	参数类型	描述
id	String	参数解释 CTS需要返回资源id 取值范围不涉及
name	String	参数解释 CTS需要返回资源name 取值范围不涉及
success_list	Array of strings	参数解释成功批量更新用例的id列表取值范围不涉及
failed_list	Array of strings	参数解释没有批量更新用例的id列表取值范围不涉及

状态码：400

**表10** 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：401

**表11** 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：404

**表12** 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：500

**表13** 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

请求示例

put https://{endpoint}/v4/a2a0efd74f5a4cc2a066306178dad16b/testcases/batch-update

{
  "version_uri" : "v90100010p0crcjn",
  "status_code" : "0",
  "case_id_list" : [ "v90100010s4pqfoe", "v90200010s2a2e78" ]
}

响应示例

状态码：200

{
  "value" : {
    "id" : "a2a0efd74f5a4cc2a066306178dad16b-v92u00010bfj1vbr...",
    "name" : "updateTestCaseListTask"
  }
}

状态码

状态码	描述
200	OK
400	Bad Request
401	Unauthorized
404	Not Found
500	Internal Server Error

错误码

请参见错误码。

父主题：自定义测试服务用例管理

上一篇：批量更新用例属性 - BatchUpdateVersionTestCases

下一篇：查询用例评论 - ListTestCaseComments

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

云宝助手提问云社区提问