配置批量删除

描述

host.massremove(对象参数)对象

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

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

参数

(对象) 参数包含要更新的主机id和应该删除的对象。 |参数|类|描述| |————-|—————————————————————————-|—————-| |hostids
(必填)|字符串/数组|待更新的主机id。| |groupids|字符串/数组|从主机组中移除指定主机。| |interfaces|对象/数组|要从给定主机中移除的主机接口。

主机接口对象必须定义了 ip 、 dns 和 port 属性。| |macros|字符串/数组|要从给定主机中删除的用户宏。| |templateids|字符串/数组|要从给定主机断开链接的模板。| |templateids_clear|字符串/数组|要从给定主机解除链接和清除的模板。|

返回值

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

示例

删除模板的链接

将模板与两台主机的链接解除，并删除所有模板实体。

请求:

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

响应:

  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.