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.