配置批量删除
描述
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
}响应:
另请参阅
源代码
CHost::massRemove() in ui/include/classes/api/services/CHost.php.