template.massupdate

描述

object template.massupdate(object parameters)

该方法允许同时替换或移除关联的objects,并更新多个模板的属性。

此方法仅适用于管理员超级管理员用户类型。调用该方法的权限可在用户角色设置中撤销。详见User roles获取更多信息。

参数

(object) 参数包含需要更新的模板ID以及用于替换模板的objects。

该方法接受以下参数。

参数 数据类型 说明
templates
(required)
object/array 待更新的模板。

模板必须定义templateid属性。
groups object/array 用于替换模板当前所属主机组的主机组。

主机组必须定义groupid属性。
macros object/array 用于替换指定模板上当前用户宏的用户宏。
templates_clear object/array 需要从指定模板解关联并清除的模板。

模板必须定义templateid属性。
templates_link object/array 用于替换当前已关联模板的模板。

模板必须定义templateid属性。

返回值

(object) 返回一个包含更新模板ID的object,存储在templateids属性下。

示例

替换主机组

从给定模板中取消关联并清除模板"10091"。

请求:

{
           "jsonrpc": "2.0",
           "method": "template.massupdate",
           "params": {
               "templates": [
                   {
                       "templateid": "10085"
                   },
                   {
                       "templateid": "10086"
                   }
               ],
               "templates_clear": [
                   {
                       "templateid": "10091"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "templateids": [
                   "10085",
                   "10086"
               ]
           },
           "id": 1
       }

另请参阅

来源

CTemplate::massUpdate() 方法位于 ui/include/classes/api/services/CTemplate.php 文件中。