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.