SaveOpenJMeterScene - 保存场景

新建或更新JMeter场景。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
pts:SaveOpenJMeterSceneupdate
  • 全部资源
    *

请求参数

名称类型必填描述示例值
OpenJMeterSceneobject

场景详情。

AgentCountinteger

施压机数量。

2
Concurrencyinteger

最大并发,并发上限由用户的资源包决定,在 mode= CONCURRENCY 时必须设置。

1000
ConstantThroughputTimerTypestring

JMeter 中的固定吞吐量定时器类型。

GLOBAL
DnsCacheConfigobject

DNS 配置。

ClearCacheEachIterationboolean

每次循环是否清空缓存。

true
DnsServersarray

DNS 服务器。

string

DNS 服务器详情。

[8.8.8.8]
HostTableobject

域名绑定。

string

域名绑定详情。

"ns.server.om":"8.8.8.8"
Durationinteger

压测持续时间,最长压测时间不超过一天,单位秒,取值范围为 60~86400。

600
EnvironmentIdstring

关联的环境 ID。

I8PZIH
FileListarray<object>

文件列表。

object

文件详情。

FileIdlong

文件 ID。

61232
FileNamestring

文件名。

test.jmx
FileOssAddressstring

文件在公网可访问的 OSS 地址。

说明 目前仅支持上海地域。
https://test.cn-shanghai.aliyuncs.com/test.jmx
FileSizelong

文件大小,文件总大小不超过 500 M,单位 Byte。

28880
Md5string

文件的 MD5。

DA70F97A74D76B6A3BEF9CC8AE0D89EB
SplitCsvboolean

是否切分,仅针对 CSV 有效。

false
Tagsstring

文件标签。

IsVpcTestboolean

是否为 VPC 测试。默认为 false,表示公网测试。当此值为 true 时,VPC 相关配置才会生效。

true
JMeterPropertiesarray<object>

JMeter 属性。

object

属性详情。

Namestring

属性名。

https.sessioncontext.shared
Valuestring

属性值。

false
JmeterPluginLabelstring

jmeter 插件标签。

test
MaxRpsinteger

最大 RPS,RPS 模式下生效。

100
Modestring

施压模型。

CONCURRENCY
RampUpinteger

预热时间,单位秒。

600
RegionIdstring

地域 ID,在 VPC 压测时配置。

cn-beijing
RegionalConditionarray<object>

施压机地域定制

object

单地域施压机数量

Amountinteger

施压机数量,所有地域施压机数量之和需要等于场景的 AgentCount 值。

1
Regionstring

地域 id

cn-hangzhou
SceneIdstring

场景 ID。没有传场景 ID 表示新建场景,传场景 ID 表示更新场景。

DYYPZIH
SceneNamestring

场景名。

test
SecurityGroupIdstring

安全组 ID,在 VPC 压测时配置。

sg-2zeid0dd7bhahsgdahspaly
StartConcurrencyinteger

起始并发,并发模式下生效,在 mode= CONCURRENCY 时必须设置。

10
StartRpsinteger

起始的 RPS,RPS 模式下生效。

10
Stepsinteger

预热阶段。

3
SyncTimerTypestring

JMeter 中的同步定时器类型。

GLOBAL
TestFilestring

测试文件。

test.jmx
VSwitchIdstring

交换机 ID,在 VPC 压测时配置。

vsw-2zehsgdhsahw1r
VpcIdstring

VPC 的 ID,在 VPC 压测时配置。

vpc-2ze2sahjdgahsebjkqhf4pyj

返回参数

名称类型描述示例值
object

返回示例。

Codestring

系统状态码,若成功则不返回该字段。

200
HttpStatusCodeinteger

HTTP 状态码,若成功则不返回该字段。

200
Messagestring

错误提示信息,若成功则不返回该字段。

RequestIdstring

请求 ID。

A8E16480-15C1-555A-922F-B736A005E52D
SceneIdstring

创建或更新的场景 ID。

DYYPZIH
Successboolean

是否成功。

  • true:成功
  • false:失败
true

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "HttpStatusCode": 200,
  "Message": "空",
  "RequestId": "A8E16480-15C1-555A-922F-B736A005E52D",
  "SceneId": "DYYPZIH",
  "Success": true
}

错误码

HTTP status code错误码错误信息描述
403SaveOpenJMeterSceneFailThe scene cannot be empty.场景内容不能为空

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-01-23OpenAPI 错误码发生变更查看变更详情
2021-12-20OpenAPI 错误码发生变更查看变更详情
2021-12-07OpenAPI 错误码发生变更查看变更详情
2021-12-01OpenAPI 错误码发生变更查看变更详情
2021-11-23OpenAPI 错误码发生变更查看变更详情
2021-11-19新增 OpenAPI查看变更详情