配置批量删除

描述

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.