批量添加
描述
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",
"description": "Test description"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
响应:
{
"jsonrpc": "2.0",
"result": {
"hostids": [
"10160",
"10167"
]
},
"id": 1
}
参考
来源
CHost::massAdd() in ui/include/classes/api/services/CHost.php.