文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试用例管理/ 在不同分支或者迭代下批量修改用例

更新时间：2025-07-24 GMT+08:00

在线调试

CLI示例

查看PDF

在不同分支或者迭代下批量修改用例

功能介绍

在不同分支或者迭代下批量修改用例

调用方法

请参见如何调用API。

URI

PUT /v4/batch/update/testcases

请求参数

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

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

表3 TestCaseAttachmentInfo
参数	是否必选	参数类型	描述
override	否	Boolean	参数解释附件是否要被覆盖约束限制不涉及取值范围 true\|false 默认取值不涉及
doc_id	否	String	参数解释文档id 约束限制不涉及取值范围不涉及默认取值不涉及
file_name	否	String	参数解释文件名约束限制不涉及取值范围不涉及默认取值不涉及
file_path	否	String	参数解释文件路径约束限制不涉及取值范围不涉及默认取值不涉及
file_type	否	String	参数解释文件类型约束限制不涉及取值范围不涉及默认取值不涉及
file_size	否	String	参数解释文件大小约束限制不涉及取值范围不涉及默认取值不涉及
override_id	否	String	参数解释重复用例ID 约束限制不涉及取值范围不涉及默认取值不涉及
related_type	否	String	参数解释相关类型约束限制不涉及取值范围不涉及默认取值不涉及
store_file_name	否	String	参数解释保存文件名约束限制不涉及取值范围不涉及默认取值不涉及
system_type	否	String	参数解释系统区分约束限制不涉及取值范围不涉及默认取值不涉及
storage_system	否	String	参数解释区分文件存储系统约束限制不涉及取值范围不涉及默认取值不涉及

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
status	String	success\|error
result	ResultValueBatchCreateUpdateApiTestCaseVo object	请求返回的数据
error	ApiError object	错误信息
request_id	String	由接口调用方传入，建议使用UUID保证请求的唯一性。definitionsdefinitions
server_address	String	本次请求的受理的服务地址

表5 ResultValueBatchCreateUpdateApiTestCaseVo
参数	参数类型	描述
total	Integer	起始记录数大于实际总条数时，值为0，分页请求才有此值
value	BatchCreateUpdateApiTestCaseVo object	请求返回的数据
reason	String	业务失败的提示内容
page_size	Integer	分页大小
page_no	Integer	分页编码
has_more	Boolean	是否有更多

表6 BatchCreateUpdateApiTestCaseVo
参数	参数类型	描述
uri	String	资源URI
type	String	资源类型
author	String	创建人
name	String	名称
rank	Integer	级别
last_modifier	String	最后修改人
last_modified	String	最后修改时间
last_modified_timestamp	Long	修改时间时间戳
last_change_time	String	最后变更时间
version_uri	String	版本URI
origin_uri	String	源资源URI
parent_uri	String	父资源URI
parent_path	String	父资源路径
creation_version_uri	String	创建版本URI
creation_date	String	创建时间
creation_date_timestamp	Long	创建时间时间戳
author_name	String	创建人名称
comment	String	备注
number	String	编号
success_list	Array of TestCaseVo objects	创建成功的用例列表
failed_list	Array of TestCaseInfo objects	创建失败的用例列表

表7 TestCaseVo
参数	参数类型	描述
uri	String	参数解释资源URI 取值范围不涉及
type	String	参数解释资源类型取值范围不涉及
author	String	参数解释创建人取值范围不涉及
name	String	参数解释名称取值范围不涉及
rank	Integer	参数解释级别取值范围不涉及
preparation	String	参数解释前置条件取值范围不涉及
remark	String	参数解释备注取值范围不涉及
stage	String	参数解释测试阶段取值范围不涉及
activity	String	参数解释测试类型取值范围不涉及
keywords	String	参数解释关键词取值范围不涉及
market	String	参数解释 apitest标记是否代码已提交取值范围不涉及
designer	String	参数解释设计者取值范围不涉及
tags	String	参数解释标签取值范围不涉及
execute_parameter	String	参数解释执行参数取值范围不涉及
region	String	参数解释逻辑region 取值范围不涉及
owner	String	参数解释处理人id，IteratorTestCase字段取值范围不涉及
last_modifier	String	参数解释最后修改人取值范围不涉及
last_modified	String	参数解释最后修改时间取值范围不涉及
last_modified_timestamp	Long	参数解释修改时间时间戳取值范围不涉及
last_change_time	String	参数解释最后变更时间取值范围不涉及
version_uri	String	参数解释版本URI 取值范围不涉及
origin_uri	String	参数解释源资源URI 取值范围不涉及
parent_uri	String	参数解释父资源URI 取值范围不涉及
parent_path	String	参数解释父资源路径取值范围不涉及
creation_version_uri	String	参数解释创建版本URI 取值范围不涉及
creation_date	String	参数解释创建时间取值范围不涉及
creation_date_timestamp	Long	参数解释创建时间时间戳取值范围不涉及
author_name	String	参数解释创建人名称取值范围不涉及
comment	String	参数解释备注取值范围不涉及
number	String	参数解释编号取值范围不涉及
case_type	Integer	参数解释父资源路径取值范围不涉及用例类型
platform_type	Integer	参数解释执行平台类型取值范围不涉及
service_type	Integer	参数解释服务类型取值范围不涉及
service_type_name	String	参数解释服务类型名称取值范围不涉及
test_type	Integer	参数解释测试类型取值范围不涉及
test_type_name	String	参数解释测试类型名称取值范围不涉及
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 取值范围不涉及
feature_name	String	参数解释目录名称取值范围不涉及
interface_name	String	参数解释测试接口名取值范围不涉及
snp_no	String	参数解释网络问题ID 取值范围不涉及
dr_relation_id	String	参数解释关联需求编号取值范围不涉及
issue_name	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	参数解释总共耗时取值范围不涉及
be_auto_type_time	String	参数解释记录用例由非自动化变为自动化类型的时间取值范围不涉及
compare_number	String	参数解释配对用例编号取值范围不涉及
scene_flag	String	参数解释场景标识取值范围不涉及
base_flag	String	参数解释场景标识取值范围不涉及
para_validator	String	参数解释区别是否从yaml中生成的用例取值范围默认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 取值范围不涉及
labels	String	参数解释用例标签名称列表取值范围不涉及
module_id	String	参数解释模块ID 取值范围不涉及
module_name	String	参数解释模块名称取值范围不涉及
module_path	String	参数解释模块path 取值范围不涉及
module_path_name	String	参数解释模块路径名称取值范围不涉及
execute_latest_time	String	参数解释最后执行时间取值范围不涉及
execute_duration	String	参数解释执行时长取值范围不涉及
execute_times	Integer	参数解释执行次数取值范围不涉及
is_keyword	Integer	参数解释是否关键用例取值范围不涉及
release_dev	String	参数解释测试版本号取值范围不涉及
new_created	String	参数解释是否用户新增用例取值范围不涉及
project_uuid	String	参数解释项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 取值范围长度等于32位，包含大小写字母、数字
creation_version_name	String	参数解释创建版本名称，原逻辑marshall添加字段取值范围不涉及
feature_path	String	参数解释特性路径，原逻辑marshall添加字段取值范围不涉及
testcase_uri	String	参数解释实体用例Uri，IteratorTestCase字段取值范围不涉及
owner_name	String	参数解释处理人名称取值范围不涉及
iterator_case_uri	String	参数解释迭代用例Uri，IteratorTestCase字段取值范围不涉及
script_link	String	参数解释脚本链接scriptLink 取值范围不涉及
test_step_model	String	参数解释测试步骤模式取值范围 text: 文本模式; table: 表格模式
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	参数解释自定义字段26 取值范围不涉及

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

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

**表10** TestCaseAttachmentInfo
参数	参数类型	描述
override	Boolean	参数解释附件是否要被覆盖约束限制不涉及取值范围 true\|false 默认取值不涉及
doc_id	String	参数解释文档id 约束限制不涉及取值范围不涉及默认取值不涉及
file_name	String	参数解释文件名约束限制不涉及取值范围不涉及默认取值不涉及
file_path	String	参数解释文件路径约束限制不涉及取值范围不涉及默认取值不涉及
file_type	String	参数解释文件类型约束限制不涉及取值范围不涉及默认取值不涉及
file_size	String	参数解释文件大小约束限制不涉及取值范围不涉及默认取值不涉及
override_id	String	参数解释重复用例ID 约束限制不涉及取值范围不涉及默认取值不涉及
related_type	String	参数解释相关类型约束限制不涉及取值范围不涉及默认取值不涉及
store_file_name	String	参数解释保存文件名约束限制不涉及取值范围不涉及默认取值不涉及
system_type	String	参数解释系统区分约束限制不涉及取值范围不涉及默认取值不涉及
storage_system	String	参数解释区分文件存储系统约束限制不涉及取值范围不涉及默认取值不涉及

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

状态码：400

**表12** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：401

**表13** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：404

**表14** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

状态码：500

**表15** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 接口调用失败错误码取值范围: 不涉及
error_msg	String	参数解释: 接口调用失败错误信息取值范围: 不涉及

请求示例

post https://{endpoint}/v4/batch/update/testcases

{
  "steps" : [ { } ],
  "attachments" : [ { } ],
  "author" : "张三",
  "name" : "用例",
  "rank" : 2,
  "owner" : "zhaoxu001",
  "preparation" : "拥有测试权限",
  "remark" : "3",
  "stage" : "3",
  "activity" : "1",
  "keywords" : "用例",
  "market" : "1",
  "designer" : "张三",
  "tags" : "aa,bb",
  "region" : "cn-north-7",
  "relate_type" : "requirement",
  "service_type" : 3,
  "only_change_script" : "true",
  "add_to_iterator" : "true",
  "need_update_relation" : "true",
  "creation_version_uri" : "001rvc8k178",
  "number" : "用例编号:-Copy-bbe028df",
  "case_type" : 0,
  "platform_type" : 0,
  "test_type" : 0,
  "design_note" : "市场",
  "test_step" : "1、点击自动化测试",
  "expect_output" : "用例结果为pass",
  "env_type" : "API_h8eXDPryNiOsEBGvSG32",
  "exe_platform" : "apitest",
  "testcase_project" : "1",
  "svn_script_path" : "ApiTest/Test(API)_Alpha/src/scripts/user/script.java",
  "map_restrict" : "api",
  "network_script_name" : "scripts.runs.CheckTestHomePage.java",
  "auto_type" : 1,
  "to_be_auto_exec" : 0,
  "last_result" : "Unavailable",
  "last_result_uri" : "001snptba6m1",
  "feature_uri" : "004sobn0n0t1",
  "interface_name" : "DtsInfoByNoPOST",
  "snp_no" : "DTS999999AAAA9999",
  "dr_relation_id" : "20830062657;20830062217;DTS999999AAAA9999",
  "test_base_num" : "12",
  "automatically_executed" : 1,
  "first_execute_time" : "2025-06-19T08:58:34.162Z",
  "detect_type" : "15",
  "execute_param" : "6",
  "test_feature" : "市场",
  "is_contract_testcase" : 1,
  "time_cost" : 5000,
  "custom_field_1" : "自定义字段1",
  "custom_field_2" : "自定义字段2",
  "custom_field_3" : "自定义字段3",
  "custom_field_4" : "自定义字段4",
  "custom_field_5" : "自定义字段5",
  "custom_field_6" : "自定义字段6",
  "custom_field_7" : "自定义字段7",
  "custom_field_8" : "自定义字段8",
  "custom_field_9" : "自定义字段9",
  "custom_field_10" : "自定义字段10",
  "custom_field_11" : "自定义字段11",
  "custom_field_12" : "自定义字段12",
  "custom_field_13" : "自定义字段13",
  "custom_field_14" : "自定义字段14",
  "custom_field_15" : "自定义字段15",
  "custom_field_16" : "自定义字段16",
  "custom_field_17" : "自定义字段17",
  "custom_field_18" : "自定义字段18",
  "custom_field_19" : "自定义字段19",
  "custom_field_20" : "自定义字段20",
  "custom_field_21" : "自定义字段21",
  "custom_field_22" : "自定义字段22",
  "custom_field_23" : "自定义字段23",
  "custom_field_24" : "自定义字段24",
  "custom_field_25" : "自定义字段25",
  "be_auto_type_time" : "2020-01-01 10:10:10",
  "compare_number" : "api",
  "scene_flag" : "Debugging Case",
  "base_flag" : "true",
  "para_validator" : "true",
  "knet_node_id" : "id",
  "last_exe_author" : "李四",
  "cloud_carrier" : "市场",
  "market_place" : "marketplace",
  "test_mind_id" : "402882e172c12ee60172c1b4642900c99",
  "test_mind_url" : "www.xxx.com",
  "commit_url" : "www.xxx.com",
  "test_pattern_number" : "402882e",
  "test_factor_number" : "4sfsd82e",
  "status_code" : "4sfsd82e",
  "result_code" : "4sfsd82e",
  "release_id" : "9374510",
  "label_id" : "46a5dbfd770f445da87b1a50ee37a86b",
  "label_names" : [ "46a5dbfd770f445da87b1a50ee37a86b" ],
  "module_id" : "60ace553eaf7c955f8cf1615",
  "execute_latest_time" : "2020-01-01 10:10:10",
  "execute_duration" : "00:00:09",
  "is_keyword" : 1,
  "release_dev" : "fd89a8d9dce64c54ade3d7fc9d6cd2dd",
  "new_created" : 1,
  "execute_parameter" : "{a:123,b:456,c:'edit'}",
  "project_uuid" : "0000dbab7df44231a72bfa25a1259c73",
  "version_uri" : "932opbu6aaf"
}

响应示例

状态码：200

{
  "status" : "success",
  "result" : {
    "total" : 1,
    "value" : [ {
      "uri" : "001s16gt6q5",
      "type" : "TestVersion",
      "author" : "efdb403066474ab08836b9eeaaa23bca",
      "name" : "名称",
      "rank" : 1,
      "last_modifier" : "efdb403066474ab08836b9eeaaa23bca",
      "last_modified" : "2025-06-19T08:58:53.074Z",
      "last_modified_timestamp" : 1660617231016,
      "last_change_time" : "2025-06-19T08:58:53.074Z",
      "version_uri" : "001s16gt68e",
      "origin_uri" : "001rv5i9u14",
      "parent_uri" : "001s16gt68e",
      "parent_path" : "/b6c4288728234a2e804b6df9465d7b5b/001s16gt68e",
      "creation_version_uri" : "001s16gt68e",
      "creation_date" : "2025-06-19T08:58:53.074Z",
      "creation_date_timestamp" : 1660617231016,
      "author_name" : "tester",
      "comment" : "备注",
      "number" : "编号",
      "success_list" : [ ],
      "failed_list" : [ ]
    } ]
  }
}

状态码

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

错误码

请参见错误码。

父主题： 测试用例管理

上一篇：ticc查询用例列表接口

下一篇：批量删除用例，同时删除与测试套的关联关系

意见反馈

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

有帮助没帮助

提供反馈

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

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

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

盘古Doer提问云社区提问

在不同分支或者迭代下批量修改用例

功能介绍

调用方法

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

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