[comment]: # ({3f9b711d-3f9b711d})
# 批量添加

[comment]: # ({/3f9b711d-3f9b711d})

[comment]: # ({8cedc1b8-30b8c9f4})
### 描述

`object hostgroup.massadd(object parameters)`

这种方法可以同时将多个相关对象添加到所有给定的主机组中。

::: noteclassic
此方法仅适用于 *Admin* 和 *Super admin* 用户类型。调用该方法的权限可在用户角色设置中撤销。 更多信息请参阅 [用户角色](/manual/web_interface/frontend_sections/users/user_roles)。
:::

[comment]: # ({/8cedc1b8-30b8c9f4})

[comment]: # ({19dffe69-b8ff6430})
### 参数

`(object)` 包含要更新的主机组 ID 以及要添加到所有主机组中的对象的参数。

该方法接受以下参数。

|参数|[Type](/manual/api/reference_commentary#data-types)|说明|
|--|--|------|
|groups|object/array|要更新的[主机组](/manual/api/reference/hostgroup/object)。<br><br>主机组必须仅定义 `groupid` 属性。<br><br>[参数行为](/manual/api/reference_commentary#parameter-behavior)：<br>- *必需*|
|hosts|object/array|要添加到所有主机组中的[主机](/manual/api/reference/host/object)。<br><br>主机必须仅定义 `hostid` 属性。|

[comment]: # ({/19dffe69-b8ff6430})

[comment]: # ({736f3b05-736f3b05})
### 返回值

`(object)` 返回一个对象，在 `groupids` 属性下包含更新的主机组 ID。

[comment]: # ({/736f3b05-736f3b05})

[comment]: # ({b41637d2-b41637d2})
### 示例

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({893ecf7b-7698103b})
#### 将主机添加到主机组

将两台主机添加到 ID 为 5 和 6 的主机组中。

[请求](/manual/api#performing-requests)：

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

响应：

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

[comment]: # ({/893ecf7b-7698103b})

[comment]: # ({6a994b89-e5f0abe1})
### 另见

-   [主机](/manual/api/reference/host/object#host)

[comment]: # ({/6a994b89-e5f0abe1})

[comment]: # ({19273fb6-19273fb6})
### 来源

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

[comment]: # ({/19273fb6-19273fb6})