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",
           "result": {
               "templateids": [
                   "10085",
                   "10086"
               ]
           },
           "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
       }

响应：

{
           "jsonrpc": "2.0",
           "result": {
               "templateids": [
                   "10074",
                   "10075",
                   "10076",
                   "10077"
               ]
           },
           "id": 1
       }

另请参阅

来源

CTemplate::massUpdate() 在 ui/include/classes/api/services/CTemplate.php 中。

Documentation

template.massupdate

描述

参数

返回值

示例

解除模板关联

替换用户宏

另请参阅

来源