批量删除
描述
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
}响应:
另见
源码
CHost::massRemove() in ui/include/classes/api/services/CHost.php.