批量创建
描述
object host.massadd(object **parameters**)
这个方法允许同时向所有给定的主机添加多个相关的对象
参数
(object)
参数包含要更新主机的ID和添加到所有主机的对象.
此方法接受如下参数:
参数 | 类型 | 描述 |
---|---|---|
hosts (必选) | 对象/数组 | 要更新的主机. 主机必须已定义过 hostid 属性. |
groups | 对象/数组 | 添加到指定主机的主机组. 主机组必须已定义过 groupid 属性. |
interfaces | 对象/数组 | 为指定主机创建主机接口. |
macros | 对象/数组 | 为指定主机创建用户宏. |
templates | 对象/数组 | 为指定主机关联模板. 模板必须已定义过 templateid 属性. |
返回值
(object)
在hostids
属性下返回包含已更新主机ID的对象.
示例
添加宏
给两个主机添加两个宏
请求:
{
"jsonrpc": "2.0",
"method": "host.massadd",
"params": {
"hosts": [
{
"hostid": "10160"
},
{
"hostid": "10167"
}
],
"macros": [
{
"macro": "{$TEST1}",
"value": "MACROTEST1"
},
{
"macro": "{$TEST2}",
"value": "MACROTEST2"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
响应:
{
"jsonrpc": "2.0",
"result": {
"hostids": [
"10160",
"10167"
]
},
"id": 1
}
参考
来源
CHost::massAdd() in frontends/php/include/classes/api/services/CHost.php.