hostgroup.massupdate

Опис

object hostgroup.massupdate(object parameters)

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

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

Параметри

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

Параметр Тип Опис
groups
(обов’язково)
object/array Групи хостів, які потрібно оновити.

Групи хостів повинні мати визначену властивість groupid.
hosts
(обов’язково)
object/array Hosts для заміни поточних хостів у вказаних групах хостів.
Усі інші хости, окрім зазначених, буде виключено з груп хостів.<br >Виявлені хости не вплинуть.

Хости повинні мати визначену властивість hostid.
шаблони
(обов’язково)
об’єкт/масив Шаблони для заміни поточних шаблонів у вказаних групах хостів.
Усі інші шаблони, окрім згаданих, буде виключено з груп хостів.<br
Шаблони повинні мати визначену властивість templateid.

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

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

Приклади

Заміна хостів і шаблонів у групі хостів

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

Запит:

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

Відповідь:

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

Дивись також

Джерело

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