SaveOpenJMeterScene API新建或更新JMeter场景-性能测试-阿里云

新建或更新JMeter场景。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

pts:SaveOpenJMeterScene

update

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
OpenJMeterScene	object	是	场景详情。
SceneName	string	是	场景名。	test
EnvironmentId	string	否	关联的环境 ID。	I8PZIH
JmeterPluginLabel	string	否	jmeter 插件标签。	test
TestFile	string	是	测试文件。	test.jmx
FileList	array	是	文件列表。
	object	否	文件详情。
FileName	string	是	文件名。	test.jmx
FileOssAddress	string	是	文件在公网可访问的 OSS 地址。说明目前仅支持上海地域。	https://test.cn-shanghai.aliyuncs.com/test.jmx
Md5	string	否	文件的 MD5。	DA70F97A74D76B6A3BEF9CC8AE0D89EB
FileId	integer	否	文件 ID。	61232
SplitCsv	boolean	否	是否切分，仅针对 CSV 有效。	false
FileSize	integer	否	文件大小，文件总大小不超过 500 M，单位 Byte。	28880
Tags	string	否	文件标签。	空
JMeterProperties	array	否	JMeter 属性。
	object	否	属性详情。
Name	string	否	属性名。	https.sessioncontext.shared
Value	string	否	属性值。	false
RampUp	integer	否	预热时间，单位秒。	600
Steps	integer	否	预热阶段。	3
Concurrency	integer	否	最大并发，并发上限由用户的资源包决定，在 mode= CONCURRENCY 时必须设置。	1000
Duration	integer	是	压测持续时间，最长压测时间不超过一天，单位秒，取值范围为 60~86400。	600
SceneId	string	否	场景 ID。没有传场景 ID 表示新建场景，传场景 ID 表示更新场景。	DYYPZIH
IsVpcTest	boolean	否	是否为 VPC 测试。默认为 false，表示公网测试。当此值为 true 时，VPC 相关配置才会生效。	true
DnsCacheConfig	object	否	DNS 配置。
ClearCacheEachIteration	boolean	否	每次循环是否清空缓存。	true
DnsServers	array	否	DNS 服务器。
	string	否	DNS 服务器详情。	[8.8.8.8]
HostTable	object	否	域名绑定。
	string	否	域名绑定详情。
AgentCount	integer	是	施压机数量。	2
RegionId	string	否	地域 ID，在 VPC 压测时配置。	cn-beijing
VpcId	string	否	VPC 的 ID，在 VPC 压测时配置。	vpc-2ze2sahjdgahsebjkqhf4pyj
SecurityGroupId	string	否	安全组 ID，在 VPC 压测时配置。	sg-2zeid0dd7bhahsgdahspaly
VSwitchId	string	否	交换机 ID，在 VPC 压测时配置。	vsw-2zehsgdhsahw1r
SyncTimerType	string	否	JMeter 中的同步定时器类型。	GLOBAL
ConstantThroughputTimerType	string	否	JMeter 中的固定吞吐量定时器类型。	GLOBAL
Mode	string	是	施压模型。	CONCURRENCY
StartRps	integer	否	起始的 RPS，RPS 模式下生效。	10
MaxRps	integer	否	最大 RPS，RPS 模式下生效。	100
StartConcurrency	integer	否	起始并发，并发模式下生效，在 mode= CONCURRENCY 时必须设置。	10
RegionalCondition	array	否	施压机地域定制
	object	否	单地域施压机数量
Region	string	否	地域 id	cn-hangzhou
Amount	integer	否	施压机数量，所有地域施压机数量之和需要等于场景的 AgentCount 值。	1

返回参数

名称	类型	描述	示例值
	object	返回示例。
SceneId	string	创建或更新的场景 ID。	DYYPZIH
RequestId	string	请求 ID。	A8E16480-15C1-555A-922F-B736A005E52D
Message	string	错误提示信息，若成功则不返回该字段。	空
HttpStatusCode	integer	HTTP 状态码，若成功则不返回该字段。	200
Code	string	系统状态码，若成功则不返回该字段。	200
Success	boolean	是否成功。 true：成功 false：失败	true

示例

正常返回示例

JSON格式

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

错误码

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

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

变更历史

更多信息，参考变更详情。