hostgroup.massadd

Опис

object hostgroup.massadd(object parameters)

Цей метод дозволяє одночасно додавати кілька пов’язаних об’єктів до всіх заданих груп хостів.

Цей метод доступний лише для користувачів типу Admin і Super admin. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. Ролі користувача для отримання додаткової інформації.

Параметри

(object) Параметри, що містять ідентифікатори груп хостів, які потрібно оновити, і об’єкти, які потрібно додати до всіх груп хостів.

Метод приймає наступні параметри.

Параметр	Тип	Опис
groups (обов’язково)	object/array	Групи хостів, які потрібно оновити. Групи хостів повинні мати визначену властивість `groupid`.
hosts	object/array	Хости для додавання до всіх груп хостів. Хости повинні мати визначену властивість `hostid`.
templates	object/array	Шаблони для додавання до всіх груп хостів. Шаблони повинні мати визначену властивість `templateid`.

Повернуті значення

(object) Повертає об’єкт, що містить ідентифікатори оновлених груп хостів у властивості groupids.

Приклади

Додавання хостів до груп хостів

Додайте два хости до груп хостів з ідентифікаторами 5 і 6.

Запит:

{
           "jsonrpc": "2.0",
           "method": "hostgroup.massadd",
           "params": {
               "groups": [
                   {
                       "groupid": "5"
                   },
                   {
                       "groupid": "6"
                   }
               ],
               "hosts": [
                   {
                       "hostid": "30050"
                   },
                   {
                       "hostid": "30001"
                   }
               ]
           },
           "auth": "f223adf833b2bf2ff38574a67bba6372",
           "id": 1
       }

Відповідь:

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

Дивись також

Джерело

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

Documentation