Documentation
批量更新
描述
hostgroup.massupdate(对象参数)对象
通过该方式，可以将多个主机组中的主机和模板替换为指定的主机和模板。
这个方法仅允许 管理员 和 超级管理员 用户类型。可以在用户角色中撤销调用方法的权限设置。详情参考 用户角色
参数
(对象) 参数包含要更新的主机组id和应该更新的对象。
| 参数 | 类 | 描述 |
|---|---|---|
| groups (必填) |
对象/数组 | 待更新的主机组。 主机组必须定义了 groupid 属性。 |
| hosts (必填) |
对象/数组 | 主机替换给定主机组上的当前主机。 除上述主机外，其他所有主机将被排除在主机组之外。 发现的主机不受影响。 主机必须定义了 hostid 属性。 |
| templates (必填) |
对象/数组 | 模板用于替换给定主机组上的当前模板。 除以上提到的模板外，其他所有模板将被排除在主机组之外。 模板必须定义了 templateid 属性。 |
返回值
(对象) 返回一个对象，该对象包含 groupids 属性下的已更新主机组的id。
示例
替换主机组中的主机
将主机组中的所有主机替换为hostid为30050的主机，并解除主机组中所有模板的链接。
请求:
{
"jsonrpc": "2.0",
"method": "hostgroup.massupdate",
"params": {
"groups": [
{
"groupid": "6"
}
],
"hosts": [
{
"hostid": "30050"
}
],
"templates": []
},
"auth": "f223adf833b2bf2ff38574a67bba6372",
"id": 1
}响应:
另请参阅
源代码
CHostGroup::massUpdate() in ui/include/classes/api/services/CHostGroup.php.