批量添加
说明
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中参考。