配置批量删除

配置批量删除

描述

host.massremove(对象参数)对象

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

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

参数

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

参数	类型	描述
hostids (必填)	字符串/数组	待更新的主机id。
groupids	字符串/数组	从主机组中移除指定主机。
interfaces	对象/数组	要从给定主机中移除的主机接口。主机接口对象必须定义了 `ip` 、 `dns` 和 `port` 属性。
macros	字符串/数组	要从给定主机中删除的用户宏。
templateids	字符串/数组	要从给定主机断开链接的模板。
templateids_clear	字符串/数组	要从给定主机解除链接和清除的模板。

返回值

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

示例

删除模板的链接

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

请求:

{
           "jsonrpc": "2.0",
           "method": "host.massremove",
           "params": {
               "hostids": ["69665", "69666"],
               "templateids_clear": "325"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "hostids": [
                   "69665",
                   "69666"
               ]
           },
           "id": 1
       }

另请参阅

源代码

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