批量添加
描述
object hostgroup.massadd(object parameters)
这种方法可以同时将多个相关对象添加到所有给定的主机组中。
此方法仅适用于 Admin 和 Super admin 用户类型。调用该方法的权限可在用户角色设置中撤销。 更多信息请参阅 用户角色。
参数
(object)
参数包含要更新的主机组 ID 和要添加到所有主机组的对象。
该方法接受以下参数。
参数 | 类型 | 说明 |
---|---|---|
groups | object/array | 待更新的 主机组。 主机组必须只定义了 groupid 属性。参数行为: - 必须 |
hosts | object/array | 要添加到所有主机组的 主机。 主机必须只定义 hostid 属性。 |
返回值
(object)
返回一个对象,在 groupids
属性下包含更新的主机组 ID。
示例
将主机添加到主机组
将两台主机添加到 ID 为 5 和 6 的主机组中。
请求:
{
"jsonrpc": "2.0",
"method": "hostgroup.massadd",
"params": {
"groups": [
{
"groupid": "5"
},
{
"groupid": "6"
}
],
"hosts": [
{
"hostid": "30050"
},
{
"hostid": "30001"
}
]
},
"id": 1
}
响应:
{
"jsonrpc": "2.0",
"result": {
"groupids": [
"5",
"6"
]
},
"id": 1
}
另见
来源
CHostGroup::massAdd() 在 ui/include/classes/api/services/CHostGroup.php.