Table of Contents
hostgroup.massadd
説明
object hostgroup.massadd(object parameters)
このメソッドは、複数の関連オブジェクトをすべての指定されたホストグループに同時に追加することを可能にします。
このメソッドは管理者およびスーパ管理者ユーザータイプでのみ利用可能です。メソッドを呼び出す権限はユーザーロールの設定で取り消すことができます。詳細はユーザーロールを参照してください。
パラメーター
(object) 更新するホストグループのIDと、すべてのホストグループに追加するオブジェクトを含むパラメーター。
このメソッドは以下のパラメーターを受け付けます。
| パラメーター | 型 | 説明 |
|---|---|---|
| groups | object/array | 更新するホストグループ。 ホストグループには groupidプロパティのみが定義されている必要があります。パラメーターの動作: - 必須 |
| hosts | object/array | すべてのホストグループに追加するホスト。 ホストには hostidプロパティのみが定義されている必要があります。 |
戻り値
(object) groupids プロパティの下で更新された host group の ID を含むオブジェクトを返します。
例
ホストをホストグループに追加する
2つのホストをIDが5と6のホストグループに追加します。
{
"jsonrpc": "2.0",
"method": "hostgroup.massadd",
"params": {
"groups": [
{
"groupid": "5"
},
{
"groupid": "6"
}
],
"hosts": [
{
"hostid": "30050"
},
{
"hostid": "30001"
}
]
},
"id": 1
}レスポンス:
関連項目
ソース
CHostGroup::massAdd() in ui/include/classes/api/services/CHostGroup.php.