批量删除

描述

object host.massremove(object parameters)

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

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

参数

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

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

参数行为:
- 必须
groupidsID/array从指定的 主机组 删除主机。
interfacesobject/array从指定的主机接口 删除主机。

主机接口对象只能由 ip, dnsport 属性定义。
macrosstring/array指定主机需要删除的用户宏
templateidsID/array指定主机需要取消链接的模板 的ID。
templateids_clearID/array指定主机需要取消链接并清理的模板 的ID。

返回值

(object) 返回一个对象,该对象包含更新的主机的 hostids 属性。

示例

取消链接模板

取消链接两台主机的目标模板,并删除所有模板实体。

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "host.massremove",
  4. "params": {
  5. "hostids": ["69665", "69666"],
  6. "templateids_clear": "325"
  7. },
  8. "id": 1
  9. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "hostids": [
  5. "69665",
  6. "69666"
  7. ]
  8. },
  9. "id": 1
  10. }

另见

源码

CHost::massRemove() in ui/include/classes/api/services/CHost.php.