批量删除
描述
object host.massremove(object parameters)
该方法允许从多个主机中移除相关对象。
这个方法仅允许 管理员 和 超级管理员 用户类型。可以在用户角色中撤销调用方法的权限设置。详情参考用户角色获取更多信息。
参数
(object)
参数包含要更新的主机id和应该删除的对象。
参数 | 类型 | 描述 |
---|---|---|
hostids | ID/array | 需要更新的主机ID。 参数行为: - 必须 |
groupids | ID/array | 从指定的 主机组 删除主机。 |
interfaces | object/array | 从指定的主机接口 删除主机。 主机接口对象只能由 ip , dns 和 port 属性定义。 |
macros | string/array | 指定主机需要删除的用户宏 。 |
templateids | ID/array | 指定主机需要取消链接的模板 的ID。 |
templateids_clear | ID/array | 指定主机需要取消链接并清理的模板 的ID。 |
返回值
(object)
返回一个对象,该对象包含更新的主机的 hostids
属性。
示例
取消链接模板
取消链接两台主机的目标模板,并删除所有模板实体。
请求:
{
"jsonrpc": "2.0",
"method": "host.massremove",
"params": {
"hostids": ["69665", "69666"],
"templateids_clear": "325"
},
"id": 1
}
响应:
{
"jsonrpc": "2.0",
"result": {
"hostids": [
"69665",
"69666"
]
},
"id": 1
}
另见
源码
CHost::massRemove() in ui/include/classes/api/services/CHost.php.