批量删除
描述
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 ui/include/classes/api/services/CHost.php.