批量添加

描述

hostgroup.massadd(对象参数)对象

该方法允许在给定的主机组中同时添加多个相关对象。

这个方法仅允许 管理员 和 超级管理员 用户类型。可以在用户角色中撤销调用方法的权限设置。详情参考 用户角色

参数

(对象) 参数包含要更新的主机组id和要添加到所有主机组的对象。

该方法接受以下参数。

参数 类 描述
groups
(必填)		 对象/数组 待更新的主机组。

主机组必须定义了 groupid 属性。
hosts 对象/数组 待添加给所有主机组的主机。

主机必须定义了 hostid 属性。
templates 对象/数组 需要添加到所有主机组的模板。

模板必须定义了 templateid 属性。

返回值

(对象) 返回一个对象，该对象包含 groupids 属性下的已更新主机组的id。

示例

给主机组添加主机

给ID为5和6的主机组添加两个主机。

请求:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.massadd",
    "params": {
        "groups": [
            {
                "groupid": "5"
            },
            {
                "groupid": "6"
            }
        ],
        "hosts": [
            {
                "hostid": "30050"
            },
            {
                "hostid": "30001"
            }
        ]
    },
    "auth": "f223adf833b2bf2ff38574a67bba6372",
    "id": 1
}

响应:

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

另请参阅

源代码

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