object template.update(object/array templates)
这个方法可以更新已经存在的模版。
这个方法只有 管理员 和 超级管理员 用户类型可以使用。可以在用户角色设置中取消调用该方法的权限。查看 用户角色获取更多信息。
(object/array)
要更新的模板属性。
必须为每个模板定义templateid
属性,其他所有属性都是可选的。只有给定的属性将被更新,所有其他属性将保持不变。
除了标准模版属性,该方法接受以下参数。
参数 | 类型 | 描述 |
---|---|---|
groups | object/array | 用于替换模板所属的当前主机组的主机群组。 主机组必须定义 groupid 属性。 |
tags | object/array | 替换当前模板标记的模板标签。 |
macros | object/array | 用户宏替换给定模板上的当前用户宏。 |
templates | object/array | 替换当前链接的模板的模版。未传递的模板仅被取消链接。 模板必须定义 templateid 属性。 |
templates_clear | object/array | 取消链接并清除给定模板的模版。 模板必须定义 templateid 属性。 |
(object)
返回一个对象,该对象包含templateids
属性下已更新模板的ID。
将模版重命名为 "Template OS Linux"。
请求:
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"name": "Template OS Linux"
},
"id": 1
}
响应:
用一个新的标签替换所有模板标签。
请求:
{
"jsonrpc": "2.0",
"method": "template.update",
"params": {
"templateid": "10086",
"tags": [
{
"tag": "Host name",
"value": "{HOST.NAME}"
}
]
},
"id": 1
}
响应:
CTemplate::update() 在 ui/include/classes/api/services/CTemplate.php.