批量删除
描述
object host.massremove(object parameters)
该方法允许从多个主机中移除相关对象。
这个方法仅允许 管理员 和 超级管理员 用户类型。可以在用户角色中撤销调用方法的权限设置。详情参考用户角色获取更多信息。
参数
(object) 包含要更新的主机 ID 以及应删除的对象的参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| hostids | ID/array | 要更新的主机的 ID。 参数行为： - 必填 |
| groupids | ID/array | 将给定主机从中移除的主机群组的 ID。 |
| interfaces | object/array | 要从给定主机中移除的主机接口。 主机接口对象必须只定义 ip、dns 和 port 属性。 |
| macros | string/array | 要从给定主机中删除的用户宏。 |
| templateids | ID/array | 要与给定主机取消关联的模板的 ID。 |
| templateids_clear | ID/array | 要与给定主机取消关联并清除的模板的 ID。 |
返回值
(object) 返回一个对象，该对象包含更新的主机的 hostids 属性。
示例
取消链接模板
取消链接两台主机的目标模板，并删除所有模板实体。
请求:
{
"jsonrpc": "2.0",
"method": "host.massremove",
"params": {
"hostids": ["69665", "69666"],
"templateids_clear": "325"
},
"id": 1
}响应:
{
"jsonrpc": "2.0",
"result": {
"hostids": [
"69665",
"69666"
]
},
"id": 1
}另请参见
源码
CHost::massRemove() in ui/include/classes/api/services/CHost.php.