Sidebar
zh:manual:api:reference:host:massremove
批量删除
描述
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.