Documentation
host.massupdate
描述
object host.massupdate(object parameters)
此方法允许在多个 主机 上同时替换或删除相关的 objects 和 update 属性。
此方法仅对 Admin 和 Super admin 用户类型可用。调用该方法的权限可以在用户角色设置中撤销。更多信息请参见 User roles。
参数
(object) 包含要 update 的 主机 ID 的参数以及 应更新的属性。
除了 主机 之外，该方法 接受以下参数。
| 参数 | 数据类型 | 描述 |
|---|---|---|
| hosts | object/array | Hosts 需要更新。 该 主机 必须仅定义了 hostid 属性。参数行为： - 必填 |
| groups | object/array | Host groups 以替换当前 主机 所属的组。主机 必须属于 主机 组，且该组必须仅定义 groupid 属性。 |
| interfaces | object/array | Host interfaces 以替换给定 主机 上当前的 主机 接口。 |
| inventory | object | 主机资产清单 属性。 主机 清单模式无法使用 inventory 参数进行更新，请改用 inventory_mode。 |
| macros | object/array | User macros 以替换给定 主机 上的当前用户宏。 |
| templates | object/array | Templates 用于替换给定 主机 上当前链接的模板。 模板必须仅定义了 templateid 属性。 |
| templates_clear | object/array | Templates 取消链接并从给定的 主机 中解除 clear。 模板必须仅定义了 templateid 属性。 |
返回值
(object) 返回一个 object，其中包含更新后的 主机 的 ID， 这些 ID 位于 hostids 属性下。
示例
启用多台主机
启用对两个 主机 的监控，即将其状态设置为 "0"。
执行请求:
{
"jsonrpc": "2.0",
"method": "host.massupdate",
"params": {
"hosts": [
{
"hostid": "69665"
},
{
"hostid": "69666"
}
],
"status": 0
},
"id": 1
}响应：
另请参阅
来源
CHost::massUpdate() 在 ui/include/classes/api/services/CHost.php 中。