Documentation
Table of Contents
hostgroup.massadd
説明
object hostgroup.massadd(object parameters)
この方法では、与えられたすべての host group に、複数の関連オブジェクトを同時に追加することができます。
このメソッドは、Admin および Super admin ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、
ユーザーロール設定で取り消すことができます。詳細については、User roles を参照してください。
パラメータ
(object) 更新する host groups のIDと、全ての host groups に追加するオブジェクトを含むパラメータ。
このメソッドは、以下のパラメータを受け付ける。
| パラメータ | Type | 説明 |
|---|---|---|
| groups (required) |
object/array | Host groups to be updated. The host groups must have the groupid property defined. |
| hosts | object/array | Hosts to add to all host groups. The hosts must have the hostid property defined. |
| templates | object/array | Templates to add to all host groups. The templates must have the templateid property defined. |
戻り値
(object) groupids プロパティの下で更新された host group の ID を含むオブジェクトを返します。
例
host group への host の追加
IDが5と6の host group に2台の host を追加します。
Request:
{
"jsonrpc": "2.0",
"method": "hostgroup.massadd",
"params": {
"groups": [
{
"groupid": "5"
},
{
"groupid": "6"
}
],
"hosts": [
{
"hostid": "30050"
},
{
"hostid": "30001"
}
]
},
"auth": "f223adf833b2bf2ff38574a67bba6372",
"id": 1
}Response:
参照
ソース
CHostGroup::massAdd() in ui/include/classes/api/services/CHostGroup.php.