批量更新

批量更新

描述

object template.massupdate(object parameters)

该方法允许同时替换或移除相关对象，并更新多个模板的属性。

这个方法只有 管理员 和 超级管理员 两个用户类型可用。可以在用户角色设置中取消调用该方法的权限。查看 [用户角色(/manual/web_interface/frontend_sections/users/user_roles) 获取更多信息。

参数

(object) 参数包含要更新的模板的ID以及要替换的对象。

这个方法接受下列参数。

参数	类型	描述
templates	object/array	要更新的模版。模版必须有已定义的 `templateid` 属性。参数行为: - 必需
groups	object/array	要替换模版所属的当前模版组的模版组。模版组必须有已经定义的 `groupid` 属性。
macros	object/array	要替换给定模版上所有当前用户宏的用户宏用户宏。
templates_clear	object/array	要从给定模版中取消链接并清除的模版。模版必须有已定义的 `templateid` 属性。
templates_link	object/array	要替换当前链接的模版。模版必须有已定义的 `templateid` 属性。

返回值

(object) 返回一个对象，该对象包含templateids属性下已更新模板的ID。

示例

取消模板的链接

从给定的模板中取消链接并清除模板 “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.