Documentation
host.massadd
描述
object host.massadd(object parameters)
此方法允许将多个相关的 objects 同时添加到所有给定的 主机。
此方法仅适用于 管理员 和 超级管理员 用户类型。调用该方法的权限可以在用户角色设置中撤销。更多信息请参见 User roles。
参数
(object) 参数包含要传递给 update 的 主机 的 ID 添加到所有 主机 的 objects。
该方法接受以下参数。
| 参数 | 数据类型 | 描述 |
|---|---|---|
| hosts | object/array | Hosts 需要更新。 该 主机 必须仅定义 hostid 属性。参数行为： - 必填 |
| groups | object/array | Host groups 添加到给定的 主机。 必须只为 主机 组定义 groupid 属性。 |
| interfaces | object/array | 为给定的 主机 创建 Host interfaces。 |
| macros | object/array | 为给定的 主机 创建 User macros。 |
| templates | object/array | Templates 用于链接到给定的 主机。 模板必须仅定义 templateid 属性。 |
返回值
(object) 返回一个 object，其中包含更新后的 主机 的 ID， 这些 ID 位于 hostids 属性下。
示例
添加宏
向两个 主机 添加两个新的宏。
执行请求:
{
"jsonrpc": "2.0",
"method": "host.massadd",
"params": {
"hosts": [
{
"hostid": "10160"
},
{
"hostid": "10167"
}
],
"macros": [
{
"macro": "{$TEST1}",
"value": "MACROTEST1"
},
{
"macro": "{$TEST2}",
"value": "MACROTEST2",
"description": "Test description"
}
]
},
"id": 1
}响应：
另请参阅
来源
CHost::massAdd() 在 ui/include/classes/api/services/CHost.php 中。