批量删除
描述
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.