This is a translation of the original English documentation page. Help us make it better.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

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:

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

参照

ソース

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