template.massupdate

描述

object template.massupdate(object parameters)

此方法允许同时对多个模板上的相关objects和update属性进行替换或移除操作.

此方法仅限AdminSuper admin用户类型使用. 调用该方法的权限可通过用户角色设置进行撤销. 更多信息请参阅User roles.

参数

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

该方法接受以下参数.

参数 数据类型 描述
templates
(required)
object/array 需要更新的模板.

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

主机组必须定义groupid属性.
macros object/array 用于替换指定模板上当前用户宏的用户宏.
templates_clear object/array 需要从给定模板解链并clear的模板.

模板必须定义templateid属性.
templates_link object/array 用于替换当前已链接模板的模板.

模板必须定义templateid属性.

返回值

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

示例

替换主机组

解除并clear模板"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 文件中。