template.massupdate

描述

object template.massupdate(object parameters)

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

此方法仅限Admin和Super 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 文件中。