[comment]: # ({3f9b711d-3f9b711d})
# hostgroup.massadd

[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})
### パラメータ

すべてのホストグループに追加するホストグループのIDおよびオブジェクトを含む`(object)`パラメータです。

このメソッドは以下のパラメータを受け付けます。

|パラメータ|[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` プロパティの下で更新された host group の ID を含むオブジェクトを返します。

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

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

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

[comment]: # ({893ecf7b-7698103b})
#### ホストグループへのホストの追加

ID 5 および 6 のホストグループに2つのホストを追加します。

[リクエスト](/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() in
*ui/include/classes/api/services/CHostGroup.php*.

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