更新时间:2024-11-28 GMT+08:00
分享

修改用例

功能介绍

修改用例

调试

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

URI

PUT /v2/{project_id}/test-cases/{case_id}

表1 路径参数

参数

是否必选

参数类型

描述

case_id

Integer

用例ID

project_id

String

项目ID,获取方式请参见获取项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

case_id

Integer

用例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

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,若不为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

bodys

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)

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

预期结果

响应参数

请求示例

修改一个用例,用例的名称修改为new_case,修改用例的请求信息,阶段信息等等。

/v2/{project_id}/test-cases/1

{
  "name" : "new_case",
  "case_type" : 0,
  "setup_contents" : [ ],
  "contents" : [ {
    "content" : [ {
      "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" : "request_example",
        "protocol_type" : 1,
        "return_timeout" : 5000,
        "return_timeout_param" : null,
        "url" : "http://127.0.0.1",
        "duration" : 120,
        "retry_delay" : 6000,
        "retry_time" : 2
      },
      "content_type" : 2
    } ],
    "content_id" : 0,
    "data" : null,
    "data_type" : 0,
    "index" : 0,
    "conditions" : [ ],
    "is_disabled" : false
  } ],
  "for_loop_params" : [ ],
  "increase_setting" : [ ],
  "stages" : [ {
    "count" : 1,
    "current_user_num" : 1,
    "issue_num" : 1,
    "name" : "Stage-2hih",
    "operate_mode" : 0,
    "pressure_mode" : 0,
    "time" : 60,
    "tps_value" : 1,
    "voltage_regulating_mode" : 0,
    "maximum" : 3,
    "minimum" : 1,
    "loop_count" : 2,
    "max_duration" : 15,
    "step_size" : 1,
    "step_duration" : 30,
    "ramp_up" : 30,
    "peak_load_kpis" : {
      "average_response_time" : {
        "comparison" : "<=",
        "value" : 60000
      },
      "success_rate" : {
        "comparison" : ">=",
        "value" : 0
      }
    }
  } ],
  "user_replicas" : 0,
  "collect_log_policy" : 0,
  "link_app_list" : [ ],
  "case_id" : 1,
  "sort" : 1,
  "status" : 1,
  "directory_id" : 174582,
  "case_info" : {
    "description" : "",
    "label_names" : [ ],
    "preparation" : "",
    "rank" : 1,
    "status_code" : 0,
    "steps" : [ {
      "expect_result" : "",
      "test_step" : ""
    } ]
  },
  "temp_id" : 0
}

响应示例

状态码

状态码

描述

204

修改用例成功响应状态码

错误码

请参见错误码

相关文档