hostgroup.massupdate

Opis

object hostgroup.massupdate(object parameters)

Ta metoda pozwala na zastąpienie hostów i szablonów określonymi w wielu grupach hostów.

Ta metoda jest dostępna tylko dla użytkowników typów Admin i Super admin. Uprawnienia do wywołania tej metody można wycofać w ustawieniach ról użytkownika. Zobacz Role użytkownika po więcej informacji.

Parametry

(object) Parametry zawierające identyfikatory grup hostów do aktualizacji i obiekty, które powinny zostać zaktualizowane.

Parametr Typ Opis
groups
(wymagane)
object/array Grupy hostów do zaktualizowania.

Grupy hostów muszą mieć zdefiniowaną właściwość groupid.
hosts
(wymagane)
object/array Hosty, które mają zastąpić obecne hosty w określonych grupach hostów.
Wszystkie inne hosty, oprócz wymienionych, zostaną wyłączone z grup hostów.
Nie będzie to miało wpływu na wykryte hosty.

Hosty muszą mieć zdefiniowaną właściwość hostid.
templates
(wymagane)
object/array Szablony, które mają zastąpić obecne szablony w określonych grupach hostów.
Wszystkie inne szablony, oprócz wymienionych, zostaną wyłączone z grup hostów.

Szablony muszą mieć zdefiniowaną właściwość templateid.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych grup hostów we właściwości groupids.

Przykłady

Zastępowanie hostów i szablonów w grupie hostów

Zastąp wszystkie hosty w grupie hostów na wymienione hosty oraz odłącz wszystkie szablony od grupy hostów.

Zapytanie:

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

Odpowiedź:

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

Zobacz także

Źródło

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