Documentation
template.massupdate
描述
object template.massupdate(object parameters)
此方法允许在多个模板上同时替换或删除相关的 objects 和 update 属性。
此方法仅对 Admin（管理员） 和 Super admin（超级管理员） 用户类型可用。 调用该方法的权限可以在用户角色设置中撤销。更多信息请参见 User roles。
参数
(object) 包含要update的模板ID以及替换模板的objects的参数。
该方法接受以下参数：
| 参数 | 数据类型 | 描述 |
|---|---|---|
| templates | object/array | 要更新的Templates。 模板必须仅定义了 templateid属性。参数行为: - 必填 |
| groups | object/array | 替换模板当前所属模板组的Template groups。 模板组必须仅定义了 groupid属性。 |
| macros | object/array | 替换给定模板上所有当前用户宏的User macros。 |
| templates_clear | object/array | 从给定模板中解除关联并clear的Templates。 模板必须仅定义了 templateid属性。 |
| templates_link | object/array | 替换当前已关联模板的Templates。 模板必须仅定义了 templateid属性。 |
返回值
(object) 返回一个 object，其中包含更新后的模板ID， 位于 templateids 属性下。
示例
解除模板关联
解除给定模板与clear模板“10091”的链接。
执行请求:
{ "jsonrpc": "2.0", "method": "template.massupdate", "params": { "templates": [ { "templateid": "10085" }, { "templateid": "10086" } ], "templates_clear": [ { "templateid": "10091" } ] }, "id": 1 }响应：
替换用户宏
在多个模板上用给定的用户宏替换所有用户宏。
执行请求:
{ "jsonrpc": "2.0", "method": "template.massupdate", "params": { "templates": [ { "templateid": "10074" }, { "templateid": "10075" }, { "templateid": "10076" }, { "templateid": "10077" } ], "macros": [ { "macro": "{$AGENT.TIMEOUT}", "value": "5m", "description": "Timeout after which agent is considered unavailable. Works only for agents reachable from Zabbix server/proxy (passive mode)." } ] }, "id": 1 }响应：
另请参阅
来源
CTemplate::massUpdate() 在 ui/include/classes/api/services/CTemplate.php 中。