文档首页/ 性能测试 CodeArts PerfTest/ API参考/ API/ 用例管理/ 修改用例（旧版）

更新时间：2025-09-15 GMT+08:00

在线调试

CLI示例

查看PDF

修改用例（旧版）

功能介绍

修改用例（旧版）

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

PUT /v1/{project_id}/task-cases/{case_id}/target/{target}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	表示项目ID，参见获取方法说明。
case_id	是	Integer	用例ID，通过“创建用例”接口获取响应体中的json.test_case_id字段的值。
target	是	String	类型

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
case_id	否	Integer	用例ID，通过“创建用例”接口获取响应体中的json.test_case_id字段的值。
name	否	String	用例名称
case_type	否	Integer	用例类型（0：常规用例；）
contents	否	Array of Contents objects	用例脚本信息
for_loop_params	否	Array of objects	旧版本逻辑控制器字段，当前已未使用
increase_setting	否	Array of objects	梯度递增
stages	否	Array of TestCaseStage objects	阶段信息
status	否	Integer	状态，0：已删除；1：启用；2：禁用
temp_id	否	Integer	用例ID，通过“创建用例”接口获取响应体中的json.test_case_id字段的值。
sort	否	Integer	排序字段
directory_id	否	Integer	用例所属目录ID（旧版接口可不传）
setup_contents	否	Array of Contents objects	前置步骤
user_replicas	否	Integer	执行器个数
collect_log_policy	否	Integer	日志采集策略（0-请求模式；1-用例模式）
link_app_list	否	Array of integers	关联全链路应用列表
case_info	否	CaseDoc object	文本用例信息

表3 TestCaseStage
参数	是否必选	参数类型	描述
operate_mode	否	Integer	压力阶段模式，0：时长模式；1：次数模式
name	否	String	阶段名称
time	否	Integer	压测时长（单位：秒）
start_time	否	Integer	开始时间
end_time	否	Integer	结束时间
issue_num	否	Integer	最大并发数
count	否	Integer	次数模式发送总次数
pressure_mode	否	Integer	压力模式，0：并发模式；1：TPS模式；2：摸高模式；3：浪涌并发模式；4：浪涌TPS模式；5：震荡并发模式；6：震荡TPS模式；7：智能摸高模式
tps_value	否	Integer	TPS模式下TPS值
current_user_num	否	Integer	起始并发数
current_tps	否	Integer	起始TPS值
voltage_regulating_mode	否	Integer	调压模式，0：自动调压模式；1：手动调压模式
maximum	否	Integer	浪涌/浪涌模式下最大并发数
minimum	否	Integer	浪涌/浪涌模式下最小并发数
loop_count	否	Integer	震荡/浪涌次数
max_duration	否	Integer	浪涌模式下峰值持续时间
ramp_up	否	Integer	摸高模式下爬坡时长（单位：秒）
peak_load_kpis	否	StageKpiItems object	摸高指标
step_duration	否	Integer	智能摸高模式下单步执行时长
step_size	否	Integer	智能摸高模式下递增并发数

表4 StageKpiItems
参数	是否必选	参数类型	描述
average_response_time	否	StageKpiItem object	平均响应时间
success_rate	否	StageKpiItem object	成功率

表5 StageKpiItem
参数	是否必选	参数类型	描述
comparison	否	String	比较符
value	否	Integer	比较值

表6 Contents
参数	是否必选	参数类型	描述
content_id	否	Integer	事务ID，通过“创建事务”接口获取响应体中的tempId字段的值。若不为0表示此卡片为事务；为0表示非事务
content	否	Array of Content objects	内容
index	否	Integer	排序索引标识
selected_temp_name	否	String	选择的事务或者用例名称
data	否	Object	数据（循环、条件控制器作用的数据）
data_type	否	Integer	数据指令类型（0：默认请求卡片；1：数据指令；201：循环指令；202：条件指令；301：集合点；203：vu百分比控制器；204：吞吐量控制器；302：插件请求）
conditions	否	Object	若类型为202：条件指令，该字段为条件配置
is_disabled	否	Boolean	是否禁用

表7 Content
参数	是否必选	参数类型	描述
content_type	否	Integer	用例卡片类型（1：思考时间；2：报文；3：检查点；4：变量提取）
content	否	ContentInfo object	内容

表8 ContentInfo
参数	是否必选	参数类型	描述
body_type	否	Integer	body类型（0：字符串；1：form-data格式；3：x-www-form-urlencoded格式）
bodys	否	Array of objects	请求体
check_end_length	否	Object	TCP/UDP协议返回数据长度
check_end_str	否	Object	TCP/UDP协议返回结束符
check_end_type	否	Object	TCP/UDP协议返回结束类型，1：返回数据长度；2：结束符
connect_timeout	否	Integer	超时时间
connect_type	否	Integer	连接设置，当前版本已未使用
headers	否	Array of ContentHeader objects	请求头
http_version	否	String	HTTP版本
method	否	String	HTTP方法
name	否	String	用例名称
protocol_type	否	Integer	协议类型（1：HTTP；2：HTTPS；3：TCP；4：UDP；7：HLS/RTMP；9：WebSocket；10：HTTP-FLV；11：MQTT）
return_timeout	否	Integer	响应超时
return_timeout_param	否	String	响应超时参数
url	否	String	请求地址
rtmp_url	否	String	rtmp地址
flv_url	否	String	flv地址
bitrate_type	否	Integer	分辨率策略
duration	否	Integer	持续时间
retry_delay	否	Integer	HLS重试延迟时间
retry_time	否	Integer	HLS重试次数

表9 ContentHeader
参数	是否必选	参数类型	描述
key	否	String	键
value	否	String	值

**表10** CaseDoc
参数	是否必选	参数类型	描述
description	否	String	用例描述信息
label_names	否	Array of strings	标签
preparation	否	String	前置条件
rank	否	Integer	用例等级（0-L0；1-L1；2-L2；3-L3；4-L4；）
status_code	否	Integer	状态（0-新建；5-设计中；6-测试中；7-完成；）
steps	否	Array of steps objects	测试步骤

**表11** steps
参数	是否必选	参数类型	描述
expect_result	否	String	步骤描述
test_step	否	String	预期结果

响应参数

状态码：202

success

状态码：501

**表12** 响应Body参数
参数	参数类型	描述
-	String	response message

请求示例

修改一个用例，给这个用例的添加一个请求。

/v1/projectId/task-cases/caseId/target/content

{
  "contents" : [ {
    "content_id" : 0,
    "content" : [ {
      "content_type" : 2,
      "content" : {
        "body_type" : 0,
        "bodys" : [ ],
        "check_end_length" : null,
        "check_end_str" : null,
        "check_end_type" : null,
        "connect_timeout" : 5000,
        "connect_type" : 1,
        "headers" : [ {
          "key" : "Content-Type",
          "value" : "application/json"
        } ],
        "http_version" : "HTTP/1.1",
        "method" : "GET",
        "name" : "Msg-24642",
        "protocol_type" : 1,
        "return_timeout" : 5000,
        "return_timeout_param" : null,
        "url" : "http://1.1.1.1"
      }
    } ],
    "index" : 0,
    "selected_temp_name" : "",
    "data" : null,
    "data_type" : 0,
    "conditions" : null,
    "is_disabled" : false
  } ],
  "for_loop_params" : [ ]
}

修改一个用例，给这个用例的添加压力阶段。

/v1/projectId/task-cases/caseId/target/stage

{
  "increase_setting" : [ ],
  "stages" : [ {
    "count" : 1,
    "current_user_num" : 10,
    "issue_num" : 10,
    "name" : "Stage-teeb",
    "operate_mode" : 0,
    "pressure_mode" : 0,
    "time" : 60,
    "tps_value" : 1,
    "voltage_regulating_mode" : 0,
    "maximum" : 3,
    "minimum" : 1,
    "loop_count" : 2,
    "max_duration" : 30,
    "step_size" : 1,
    "step_duration" : 30,
    "ramp_up" : 30,
    "peak_load_kpis" : {
      "average_response_time" : {
        "comparison" : "<=",
        "value" : 60000
      },
      "success_rate" : {
        "comparison" : ">=",
        "value" : 0
      }
    }
  } ]
}

修改一个用例，用例的名称修改为testCase。

/v1/projectId/task-cases/caseId/target/name

{
  "name" : "testCase"
}

响应示例

无

状态码

状态码	描述
202	success
501	unknown error

错误码

请参见错误码。

父主题： 用例管理

上一篇：删除用例（旧版）

下一篇：调试用例（旧版）

意见反馈

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

有帮助没帮助

提供反馈

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

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

直接提交取消

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

盘古Doer提问云社区提问

修改用例（旧版）

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

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