批量添加

说明

object template.massadd(object parameters)

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

参数

(object)参数包含需要更新的模板ID以及添加到模板的对象。

该方法接受以下参数。

参数 类 说明
templates
(required 必须)		 object/array模 需要更新的模板。
必须定义templateid属性。
groups object/array 主机组添加指定的模板。
主机组必须定义groupid属性。
hosts object/array 将主机和模板链接到指定的模板中。
主机必须定义hostid属性。
macros object/array 为指定的模板创建用户宏。
templates_link object/array 将模板链接到指定模板。
模板必须定义templateid属性。

返回值

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

范例

添加模板到组

添加两个模板到ID为"2"的主机组中。

Request 请求:

{
    "jsonrpc": "2.0",
    "method": "template.massadd",
    "params": {
        "templates": [
            {
                "templateid": "10085"
            },
            {
                "templateid": "10086"
            }
        ],
        "groups": [
            {
                "groupid": "2"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Response 响应:

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

链接模板到主机

链接ID为"10073"的模板到两台主机。

Request 请求:

{
    "jsonrpc": "2.0",
    "method": "template.massadd",
    "params": {
        "templates": [
            {
                "templateid": "10073"
            }
        ],
        "hosts": [
            {
                "hostid": "10106"
            },
            {
                "hostid": "10104"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Response 响应:

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

参考

源码

CTemplate::massAdd()方法可在ui/include/classes/api/services/CTemplate.php中参考。