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.