批量更新
描述
object host.massupdate(object parameters)
此方法允许同时对多个主机替换或移除相关对象和更新属性
参数
(object) 参数包含更新主机的ID和需要更新的属性.
另外，对于标准的主机属性，此方法可以接受如下参数:
| 参数 类 | 描述 | |
|---|---|---|
| hosts (必选) | 对象/数组 要更新 | 主机 机必须已定义过 hostid属性. |
| groups | 对象/数组 替换当 | 主机所属主机组. 主机组必须已定义过 groupid属性. |
| interfaces | 对象/数组 在指定 | 机上替换当前主机接口. |
| inventory | 对象 主 | 资产清单属性. 使用参数 inventory无法更新主机资产清单模式，用参数inventory_mode替换. |
| inventory_mode | 整数 主 | 资产清单群体模式. 参考 host inventory object page 获取支持的资产清单模式列表. |
| macros | 对象/数组 在指定 | 机中替换当前用户宏. |
| templates | 对象/数组 在指定 | 机中替换当前链接的模板. 模板必须已定义过 templateid属性. |
| templates_clear | 对象/数组 移除给 | 主机的模板关联，并清空与该模板关联的数据. 模板必须已定义过templateid属性. |
返回值
(object) 在hostids属性中返回包含已更新主机ID对象.
示例
启用多个主机
启用两个主机，将status设置为0
请求:
{ "jsonrpc": "2.0", "method": "host.massupdate", "params": { "hosts": [ { "hostid": "69665" }, { "hostid": "69666" } ], "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }响应:
参考
来源
CHost::massUpdate() in frontends/php/include/classes/api/services/CHost.php.