批量删除

描述

object host.massremove(object parameters)

这个方法允许同时向所有给定的主机移除相关的对象

参数

(object) 参数包含要更主机的ID和应该移除的对象.

参数 类 描述
hostids
(必选)
字符串/数组 要更新的 机的ID.
groupids 字符串/数组 移除给定 机的主机组.
interfaces 对象/数组 移除给 主机的主机接口.

主机接口对象必须已定义ip, dns and port属性.
macros 字符串/数组 移除给定 机的用户宏.
templateids 字符串/数组 移除给定 机的模板关联.
templateids_clear 字符串/数组 移除给定 机的模板关联,并清空与该模板关联的数据.

返回值

(object)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 frontends/php/include/classes/api/services/CHost.php.