保存或修改场景。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
pts:SavePtsScene |
update |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Scene |
object |
是 |
场景详细信息。 |
|
| SceneId |
string |
否 |
场景 ID。没有传场景 ID 表示新建场景,传场景 ID 表示更新场景。 |
IUYAHGJ |
| SceneName |
string |
是 |
场景名。 |
test |
| RelationList |
array |
是 |
链路配置。 |
|
|
array<object> |
否 |
|||
| RelationName |
string |
是 |
链路名。 |
链路1 |
| RelationId |
string |
否 |
链路 ID。 |
1 |
| ApiList |
array |
是 |
链路下的 API 信息。 |
|
|
array<object> |
否 |
|||
| ApiName |
string |
是 |
API 名称。 |
api |
| Url |
string |
是 |
压测 URL。 |
http://www.example.com |
| Method |
string |
是 |
请求方法。 |
GET |
| ApiId |
string |
否 |
API 的 ID。 |
1 |
| ExportList |
array |
否 |
出参。 |
|
|
object |
否 |
|||
| ExportType |
string |
否 |
出参来源。包括:
|
BODY_JSON |
| ExportName |
string |
否 |
出参名。 |
test |
| Count |
string |
否 |
第几个匹配项。可以是数字或 Random,当出参来源为请求体(BODY_TEXT)时需要填写该项。 |
0 |
| ExportValue |
string |
否 |
出参的解析表达式。 |
data.itemlist[0] |
| HeaderList |
array |
否 |
Header 请求头。 |
|
|
object |
否 |
|||
| HeaderName |
string |
否 |
Header 参数名。 |
Accept-Encoding |
| HeaderValue |
string |
否 |
参数对应的值。 |
gzip, deflate, br |
| CheckPointList |
array |
否 |
检查点。 |
|
|
object |
否 |
|||
| Operator |
string |
否 |
检查点条件。 |
ctn |
| ExpectValue |
string |
否 |
检查内容,即期望值。 |
111 |
| CheckType |
string |
否 |
检查点类型。包括:
|
EXPORTED_PARAM |
| CheckPoint |
string |
否 |
检查对象。 当 |
userId |
| TimeoutInSecond |
integer |
否 |
API 超时时间。单位秒,默认 5s,取值范围[1-60]。 |
5 |
| Body |
object |
否 |
请求 Body。 |
|
| ContentType |
string |
否 |
Body 类型,默认 |
application/x-www-form-urlencoded |
| BodyValue |
string |
否 |
body 的实际内容。例如, {"key1":"value2","key2":"value2"}。 |
{\"global\":\"${global}\",\"name\":\"${name}\"} |
| RedirectCountLimit |
integer |
是 |
重定向次数。只能是 0(允许重定向)或者 10(不允许重定向),用户根据自己的情况配置。 |
0 |
| FileParameterExplainList |
array |
否 |
链路中的文件参数配置信息。 |
|
|
object |
否 |
|||
| FileName |
string |
是 |
文件名。 |
fileName.csv |
| FileParamName |
string |
是 |
文件使用的参数列名。 |
name,uid,age |
| BaseFile |
boolean |
否 |
是否作为基准文件。 |
true |
| CycleOnce |
boolean |
否 |
文件是否轮询一次。 |
true |
| LoadConfig |
object |
是 |
施压配置。 |
|
| TestMode |
string |
是 |
施压模式。包括:
|
concurrency_mode |
| Configuration |
object |
是 |
场景施压量级配置信息。 |
|
| AllRpsBegin |
integer |
否 |
所有 API 的起始 RPS 总值。 均分给每个 API,在 RPS 模式下使用,若不设置该值,则 apiLoadConfig 必须填写。 |
100 |
| AllRpsLimit |
integer |
否 |
所有 API 的最大 RPS 总值。 均分给每个 API,在 RPS 模式下使用,若不设置该值,则 apiLoadConfig 必须填写。 |
100 |
| AllConcurrencyBegin |
integer |
否 |
所有链路的起始并发总值。 均分给每个链路,在并发模式下使用,若不设置该值,则 relationLoadConfig 必须填写。 |
100 |
| AllConcurrencyLimit |
integer |
否 |
所有链路的最大并发总值。 均分给每个链路,在并发模式下使用,若不设置该值,则 relationLoadConfig 必须填写。 |
100 |
| MaxRunningTime |
integer |
是 |
施压时长。单位分钟,取值范围[1-1440]。 |
10 |
| AutoStep |
boolean |
否 |
是否自动递增。只有在并发模式下有效,即 |
true |
| AgentCount |
integer |
否 |
指定机器数。并发需要>250(RPS>2000)时使用,最大扩展机器数不能超过最大并发数/250(最大 RPS/2000)。 |
1 |
| Increment |
integer |
否 |
递增百分比。取值范围[10,100],取值需是 10 的倍数。 只在并发模式且同时是自动递增模式下有效,即 |
30 |
| KeepTime |
integer |
否 |
单量级持续时长。单位分钟,该时长需小于施压时长 maxRunningTime。 |
3 |
| ApiLoadConfigList |
array |
否 |
API 的起始、最大 RPS 值设置,在 RPS 模式下使用。 |
|
|
object |
否 |
|||
| ApiId |
string |
是 |
API ID。 |
1 |
| RpsLimit |
integer |
是 |
最大 RPS 值。 |
100 |
| RpsBegin |
integer |
是 |
起始 RPS 值。 |
100 |
| VpcLoadConfig |
object |
否 |
VPC 配置。 |
|
| VpcId |
string |
是 |
VPC ID。 |
vpc-akjhsdajgjsfggahjkga |
| VSwitchId |
string |
是 |
交换机 ID。 |
vsw-skjfhlahsljkhsfalkjdoiw |
| SecurityGroupId |
string |
是 |
安全组 ID。 |
sg-jkasgfieiajidsjakjscb |
| RegionId |
string |
是 |
地域 ID。 |
cn-beijing |
| RelationLoadConfigList |
array |
否 |
链路的起始、最大并发值设置,在并发模式下使用。 |
|
|
object |
否 |
|||
| RelationId |
string |
否 |
链路 ID。 |
1 |
| ConcurrencyLimit |
integer |
是 |
最大并发数。 |
100 |
| ConcurrencyBegin |
integer |
是 |
起始并发。 |
100 |
| AdvanceSetting |
object |
否 |
高级设置。 |
|
| LogRate |
integer |
否 |
日志采样率。取值范围[1,50],大于 2 时取值需要是 10 的倍数,即[1,10,20,30,40,50]。 |
1 |
| DomainBindingList |
array |
否 |
域名绑定 IP 关系。 |
|
|
object |
否 |
|||
| Domain |
string |
否 |
域名。 |
www.example.com |
| Ips |
array |
否 |
对应的 IP。 |
|
|
string |
否 |
["192.168.1.1","192.168.1.2"] |
||
| ConnectionTimeoutInSecond |
integer |
否 |
超时时间,单位秒。 |
5 |
| SuccessCode |
string |
否 |
新增成功状态码,多个需用半角逗号(,)隔开。 |
205 |
| GlobalParameterList |
array |
否 |
全局自定义参数。 |
|
|
object |
否 |
|||
| ParamName |
string |
否 |
参数名。 |
global |
| ParamValue |
string |
否 |
全局参数值,不可参数化。 |
11111 |
| FileParameterList |
array |
否 |
文件参数。 |
|
|
object |
否 |
|||
| FileName |
string |
否 |
文件名。 |
test.csv |
| FileOssAddress |
string |
否 |
您自己的 OSS 文件地址,要求公网可访问。 |
https://jmeter-pts-testing-version.oss-cn-shanghai.aliyuncs.com/param-file.csv |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| Message |
string |
错误信息提示,若成功则为空。 |
空 |
| RequestId |
string |
请求 ID。 |
A8E16480-15C1-555A-922F-B736A005E52D |
| HttpStatusCode |
integer |
HTTP 状态码。 |
200 |
| Code |
string |
系统状态码。 |
200 |
| Success |
boolean |
是否成功。
|
true |
| SceneId |
string |
场景 ID |
IUYAHGJ |
示例
正常返回示例
JSON格式
{
"Message": "空",
"RequestId": "A8E16480-15C1-555A-922F-B736A005E52D",
"HttpStatusCode": 200,
"Code": "200",
"Success": true,
"SceneId": "IUYAHGJ"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | ModifyPtsSceneFail | The scene does not exit |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。