文档首页/ 性能测试 CodeArts PerfTest/ API参考/ API/ 全局变量管理/ 创建变量
更新时间：2025-09-15 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建变量

功能介绍

创建变量

调试

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

URI

POST /v1/{project_id}/variables/{test_suite_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

表示项目ID，参见获取方法说明。

test_suite_id

是

Integer

测试工程ID，通过“创建工程”接口获取响应体中的project_id字段的值。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

[数组元素]

是

Array of CreateVariableRequestBody objects

CreateVariableRequestBody
表3 CreateVariableRequestBody

参数

是否必选

参数类型

描述

id

是

Integer

变量ID，通过“创建变量”接口获取响应体中的json.variable_id字段的值。

name

是

String

变量名称

variable_type

是

Integer

变量类型（1：整数；2：枚举；3：文件；5：文本）

variable

是

Array of objects

变量值

is_quoted

是

Boolean

是否被引用

响应参数

状态码：201

表4 响应Body参数

参数

参数类型

描述

code

String

响应码

json

CreateVariableResultJson object

响应json

message

String

响应消息
表5 CreateVariableResultJson

参数

参数类型

描述

variable_id

Integer

变量ID，通过“创建变量”接口获取响应体中的json.variable_id字段的值。

状态码：501

表6 响应Body参数

参数

参数类型

描述

-

String

response message

请求示例

创建一个全局变量，变量所属工程ID是1，变量名是varTest，变量类型是整数，变量值区间是从1到10。

/v1/projectId/variables/1

[ {
  "name" : "varTest",
  "variable_type" : 1,
  "variable" : [ 1, 10 ],
  "is_quoted" : false
} ]

响应示例

状态码：201

success

{
  "code" : "SVCSTG.CPTS.0000000",
  "json" : {
    "variable_id" : 44245
  },
  "message" : "success"
}

状态码

状态码

描述

201

success

501

unknown error

错误码

请参见错误码。

父主题： 全局变量管理

相关文档