批量删除

描述

object host.massremove(object parameters)

该方法允许从多个主机中移除相关对象。

这个方法仅允许 管理员超级管理员 用户类型。可以在用户角色中撤销调用方法的权限设置。详情参考用户角色获取更多信息。

参数

(object) 参数包含要更新的主机id和应该删除的对象。

参数 类型 描述
hostids ID/array 需要更新的主机ID。

参数行为:
- 必须
groupids ID/array 从指定的 主机组 删除主机。
interfaces object/array 从指定的主机接口 删除主机。

主机接口对象只能由 ip, dnsport 属性定义。
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.