批量更新

描述

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
}

响应:

{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "6",
        ]
    },
    "id": 1
}

另请参阅

源代码

CHostGroup::massUpdate() in ui/include/classes/api/services/CHostGroup.php.