文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 自定义测试服务用例管理/ 在分支或者测试计划下修改用例 - UpdateVersionTestCase
更新时间:2026-07-28 GMT+08:00
分享

在分支或者测试计划下修改用例 - UpdateVersionTestCase

功能介绍

此接口用于在分支或者测试计划下修改用例,同页面 测试 -> 测试计划 -> 右侧展示页面,点击对应测试计划,进入测试计划详情页 -> 右侧展示页面,左上角可点击添加用例

调用方法

请参见如何调用API。

URI

PUT /GT3KServer/v4/testcases/{testcase_id}

表1 路径参数

参数

是否必选

参数类型

描述

testcase_id

是

String

参数解释:

用例id

约束限制:

不涉及

取值范围:

字母、数字,长度为11到34位

默认取值:

不涉及

获取方法:

从GET /GT3KServer/v4/{project_id}/testcases/batch-query的返回字段获取

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

必传。

取值范围:

字符串长度不少于1,不超过10万。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

case_uri

否

String

参数解释

用例的主键

约束限制

长度限制32字符

取值范围

不涉及

默认取值

不涉及

attachments

否

Array of TestCaseAttachmentInfo objects

参数解释:

对外附件

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

steps

否

Array of TestCaseStepInfo objects

参数解释:

测试步骤

约束限制:

不涉及

取值范围:

0-100

默认取值:

不涉及

author

否

String

参数解释

创建人

约束限制

1-32个英文或者数字

取值范围

不涉及

默认取值

不涉及

name

是

String

参数解释

名称

约束限制

长度限制128字符

取值范围

不涉及

默认取值

不涉及

rank

是

Integer

参数解释

用例等级

约束限制

不涉及

取值范围

取值范围:0,1,2,3,4

默认取值

不涉及

owner

否

String

参数解释

处理人

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

preparation

否

String

参数解释

前置条件

约束限制

长度限制3000字符

取值范围

不涉及

默认取值

不涉及

remark

否

String

参数解释

备注

约束限制

不涉及

取值范围

不超过20000字符

默认取值

不涉及

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

参数解释:

关联关系类型

约束限制:

不涉及

取值范围:

  • bug,缺陷。

  • requirement,需求。

默认取值:

不涉及

service_type

是

Integer

参数解释:

服务类型

约束限制:

不涉及

取值范围:

  • -1,全量用例。

  • 0,手工测试。

  • 1,接口自动化。

  • 7,功能自动化。

  • 8,WebUI自动化。

  • 100,自定义自动化(工厂)。

  • 11,性能自动化。

默认取值:

不涉及

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

参数解释:

用例类型

约束限制:

不涉及

取值范围:

  • 0,手工测试。

  • 1,接口自动化。

  • 2,性能用例。

默认取值:

不涉及

platform_type

否

Integer

参数解释

执行平台类型

约束限制

不涉及

取值范围

取值范围:-128-127

默认取值

不涉及

test_type

否

Integer

参数解释:

测试类型

取值范围:

  • 1,功能性测试。

  • 2,兼容性测试。

  • 4,性能测试。

  • 15,易用性测试。

  • 22,可靠性测试。

  • 14,安全性测试。

  • 21,可服务性测试。

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,是自动化。

默认取值:

不涉及

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

参数解释

最后执行时间

约束限制

不涉及

取值范围

格式为yyyy-MM-dd HH:mm:ss

默认取值

不涉及

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

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表4 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

参数解释

区分文件存储系统

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表5 TestCaseStepInfo

参数

是否必选

参数类型

描述

test_step

否

String

参数解释

测试步骤

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

expect_result

否

String

参数解释

预期结果

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

step_actual

否

String

参数解释

步骤的实际结果

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

step_result

否

String

参数解释

步骤结果

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

响应参数

状态码:200

表6 响应Body参数

参数

参数类型

描述

value

TestCaseVo object

参数解释:

请求返回的数据

取值范围:

不涉及

表7 TestCaseVo

参数

参数类型

描述

uri

String

参数解释

用例URI

取值范围

11-34位字母及数字

type

String

参数解释:

资源类型

取值范围:

  • TestCase,用例。

  • Task,任务。

  • TestVersion,分支。

  • IteratorTestCase,迭代用例。

author

String

参数解释

创建人

取值范围

长度1-128字符

name

String

参数解释

名称

取值范围

长度1-128字符

rank

Integer

参数解释

用例等级

取值范围

  • 0,Priority 0。

  • 1,Priority 1。

  • 2,Priority 2。

  • 3,Priority 3。

  • 4,Priority 4。

preparation

String

参数解释

前置条件

取值范围

长度1-128字符

remark

String

参数解释

备注

取值范围

长度1-128字符

stage

String

参数解释

测试阶段

取值范围

不涉及

activity

String

参数解释

测试类型

取值范围

长度1-128字符

keywords

String

参数解释

关键词

取值范围

长度1-128字符

market

String

参数解释

apitest标记是否代码已提交

取值范围

长度1-128字符

designer

String

参数解释

设计者

取值范围

长度1-128字符

tags

String

参数解释

标签

取值范围

长度1-128字符

execute_parameter

String

参数解释

执行参数

取值范围

长度1-128字符

region

String

参数解释

逻辑region

取值范围

长度1-128字符

owner

String

参数解释

处理人id,IteratorTestCase字段

取值范围

长度1-128字符

last_modifier

String

参数解释

最后修改人

取值范围

长度1-128字符

last_modified

String

参数解释

最后修改时间

取值范围

长度1-128字符

last_modified_timestamp

Long

参数解释

修改时间时间戳

取值范围

时间戳格式,单位为毫秒

last_change_time

String

参数解释

最后变更时间

取值范围

时间格式为"yyyy-MM-dd HH:mm:ss"

version_uri

String

参数解释

版本URI

取值范围

11-34位字母及数字

origin_uri

String

参数解释

源资源URI

取值范围

11-34位字母及数字

parent_uri

String

参数解释

父资源URI

取值范围

11-34位字母及数字

parent_path

String

参数解释

父资源路径

取值范围

不涉及

creation_version_uri

String

参数解释

创建版本URI

取值范围

11-34位字母及数字

creation_date

String

参数解释

创建时间

取值范围

时间格式为"yyyy-MM-dd HH:mm:ss"

creation_date_timestamp

Long

参数解释

创建时间时间戳

取值范围

时间戳格式,单位为毫秒

author_id

String

参数解释

创建人ID

取值范围

不涉及

author_name

String

参数解释

创建人名称

取值范围

长度1-128字符

comment

String

参数解释

备注

取值范围

长度1-128字符

number

String

参数解释

编号

取值范围

长度1-128字符

case_type

Integer

参数解释:

用例类型

取值范围:

  • 0,手工测试。

  • 1,接口自动化。

  • 2,性能用例。

platform_type

Integer

参数解释

执行平台类型

取值范围

不涉及

service_type

Integer

参数解释:

服务类型

取值范围:

  • -1,全量用例。

  • 0,手工测试。

  • 1,接口自动化。

  • 7,功能自动化。

  • 8,WebUI自动化。

  • 100,自定义自动化(工厂)。

  • 11,性能自动化。

service_type_name

String

参数解释

服务类型名称

取值范围

长度1-128字符

test_type

Integer

参数解释:

测试类型

取值范围:

  • 1,性能。

  • 2,安全。

  • 3,功能。

  • 4,韧性可靠性。

  • 5,过载场景。

test_type_name

String

参数解释

测试类型名称

取值范围

长度1-128字符

design_note

String

参数解释

设计描述

取值范围

长度1-128字符

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_id

String

参数解释

工作项id

取值范围

不涉及

issue_tracker_id

String

参数解释

工作项类型id

取值范围

不涉及

issue_assign_status

String

参数解释

工作项分配状态

取值范围

不涉及

issue_name

String

参数解释

需求名称

取值范围

不涉及

issue_design_owner

String

参数解释

工作项设计责任人

取值范围

不涉及

issue_design_owner_d

String

参数解释

工作项设计责任人id

取值范围

不涉及

tracker_name

String

参数解释

工作项类型名称

取值范围

不涉及

defect_list

Array of NameAndId objects

参数解释

缺陷列表

取值范围

不涉及

result_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

参数解释

用例标签名称列表

取值范围

不涉及

status_name

String

参数解释

状态名称

取值范围

不涉及

module_id

String

参数解释

模块ID

取值范围

不涉及

module_name

String

参数解释

模块名称

取值范围

不涉及

module_path

String

参数解释

模块path

取值范围

不涉及

module_path_name

String

参数解释

模块路径名称

取值范围

不涉及

execute_latest_time

String

参数解释

最后执行时间

取值范围

格式为yyyy-MM-dd HH:mm:ss

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

参数解释

自定义字段25

取值范围

不涉及

表8 NameAndId

参数

参数类型

描述

id

String

参数解释:

对象编号

取值范围:

11-34位的字母及数字(字符串)

name

String

参数解释:

对象名称

取值范围:

不涉及

状态码:400

表9 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码:401

表10 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码:404

表11 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码:500

表12 响应Body参数

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

请求示例

put https://{endpoint}/GT3KServer/v4/testcases/v92u00010e58tdun

{
  "author": "f3b807a0d249424fa36a0d804110c4ed",
  "name": "cccc",
  "rank": 2,
  "stage": "1",
  "designer": "f3b807a0d249424fa36a0d804110c4ed",
  "region": "cn-north-7",
  "version_uri": "v92s00010db209le",
  "number": "101",
  "case_type": 0,
  "platform_type": 0,
  "service_type": 0,
  "test_type": 1,
  "test_step": "[\"\"]","expect_output":"[\"\"]",
  "auto_type": 0,
  "to_be_auto_exec": 0,
  "dr_relation_id": "1119663863142195200",
  "automatically_executed": 0,
  "is_contract_testcase": 0,
  "time_cost": 0,
  "status_code": "0",
  "is_keyword": 0,
  "project_uuid": "dc3f9aa646ad4707831080d3fcce474d",
  "steps": [{
    "test_step": "",
    "expect_result": ""
  }],
  "remark": "xx",
  "label_names": [],
  "release_dev": "",
}

响应示例

状态码:200

OK

{
  "value" : {
    "uri" : "v90100010s45qt1e",
    "type" : "TestCase",
    "author" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
    "name" : "添加的用例",
    "rank" : 2,
    "stage" : "1",
    "designer" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
    "region" : "region-1",
    "owner" : "",
    "last_modifier" : "c6a01bc6f2984a2098b423ce0ab1fdeb",
    "last_modified" : "2025-10-21 16:57:24",
    "last_change_time" : "2025-10-21 16:57:24",
    "version_uri" : "v90200010rvlmvjf",
    "parent_uri" : "v90200010rvlmvjf",
    "parent_path" : "/3c913532482340e69b9b724f6732c67c/v90200010rvlmvjf/",
    "creation_date" : "2025-10-18 10:12:21",
    "number" : "101",
    "case_type" : 0,
    "platform_type" : 0,
    "service_type" : 1,
    "test_type" : 1,
    "test_step" : "[\"\"]",
    "expect_output" : "[\"\"]",
    "svn_script_path" : "ApiTest/Scrum_alpha/src/scripts/user/Case_594dd61a40374eef8e9db091c8973976_1.java",
    "auto_type" : 0,
    "to_be_auto_exec" : 0,
    "automatically_executed" : 0,
    "is_contract_testcase" : 0,
    "time_cost" : 0,
    "status_code" : "0",
    "execute_times" : 0,
    "is_keyword" : 0,
    "project_uuid" : "3c913532482340e69b9b724f6732c67c"
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

相关文档