添加应用配置模板
功能介绍
添加应用配置模板
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/templates/apps/configs
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。获取方法请参见 获取项目ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务 获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 最小长度:0 最大长度:20000 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
tpl_id |
是 |
String |
模板id 最小长度:1 最大长度:64 |
name |
是 |
String |
模板名称,允许中、数字、英文大小写、下划线、中划线 最小长度:1 最大长度:64 |
description |
是 |
String |
描述 最小长度:0 最大长度:128 |
config_tabs |
是 |
Object |
配置项元数据 |
default_values |
否 |
Object |
默认配置数据 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
tpl_id |
String |
模板id 最小长度:1 最大长度:64 |
name |
String |
模板名称 最小长度:1 最大长度:64 |
description |
String |
描述 最小长度:0 最大长度:128 |
config_tabs |
Object |
配置项数据 |
default_values |
Object |
默认数据 |
create_time |
String |
创建时间 最小长度:0 最大长度:256 |
update_time |
String |
最后一次修改时间 最小长度:0 最大长度:256 |
请求示例
POST https://{endpoint}/v2/{project_id}/templates/apps/configs { "tpl_id" : "general_app_tpl", "name" : "general_app_tpl", "description" : "通用应用配置模板", "config_tabs" : [ { "key" : "connection_info", "name" : "连接信息", "description" : "连接信息", "config_items" : [ { "key" : "endpoint", "name" : "服务端点", "description" : "服务完整URL", "data_type" : "string", "required" : true, "crypted" : false, "max_length" : 128, "example" : "opc.tcp://127.0.0.1:53530/OPCUA" }, { "key" : "username", "name" : "用户名", "description" : "OPCUA服务器认证用户名", "data_type" : "string", "required" : false, "crypted" : false, "max_length" : 128, "example" : "admin" }, { "key" : "password", "name" : "密码", "description" : "OPCUA服务器认证密码", "data_type" : "string", "required" : false, "crypted" : true, "max_length" : 512, "example" : "******" } ] }, { "key" : "collection_paras", "name" : "连接附加参数", "description" : "连接附加参数", "config_items" : [ { "key" : "default_cycle", "name" : "采集周期", "description" : "采集周期", "data_type" : "int", "required" : true, "crypted" : false, "max_length" : 65535, "example" : 10000 } ] } ], "default_values" : { "appname" : "LINK" } }
响应示例
状态码: 200
OK
{ "tpl_id" : "general_app_tpl", "name" : "general_app_tpl", "description" : "通用应用模板", "config_tabs" : [ { "key" : "connection_info", "name" : "连接信息", "description" : "连接信息", "config_items" : [ { "key" : "endpoint", "name" : "服务端点", "description" : "服务完整URL", "example" : "opc.tcp://127.0.0.1:53530/OPCUA" }, { "key" : "username", "name" : "用户名", "description" : "OPCUA服务器认证用户名", "example" : "admin" }, { "key" : "password", "name" : "密码", "description" : "OPCUA服务器认证密码", "data_type" : "string" } ] }, { "key" : "collection_paras", "name" : "连接附加参数", "description" : "连接附加参数", "config_items" : [ { "key" : "default_cycle", "name" : "采集周期", "description" : "采集周期" } ] } ], "default_values" : { "appname" : "LINK" } }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
404 |
Not Found |
错误码
请参见错误码。