hostgroup.massupdate

Opis

object hostgroup.massupdate(object parameters)

Ta metoda umożliwia zastąpienie hostów i szablonów określonymi elementami w wielu grupach hostów.

Ta metoda jest dostępna tylko dla typów użytkowników Admin i Super admin. Uprawnienia do wywołania metody można cofnąć w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.

Parametry

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

Parameter Type Description
groups object/array Grupy hostów do zaktualizowania.

Grupy hostów muszą mieć zdefiniowaną tylko właściwość groupid.

Zachowanie parametru:
- required
hosts object/array Hosty do zastąpienia bieżących hostów w podanych grupach hostów.
Wszystkie pozostałe hosty, z wyjątkiem wymienionych, zostaną wykluczone z grup hostów.
Wykryte hosty nie zostaną objęte zmianą.

Hosty muszą mieć zdefiniowaną tylko właściwość hostid.

Zachowanie parametru:
- required

Zwracane wartości

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

Przykłady

Zastępowanie hostów w grupie hostów

Zastąp wszystkie hosty w grupie hostów hostem wskazanym poniżej.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.massupdate",
    "params": {
        "groups": [
            {
                "groupid": "6"
            }
        ],
        "hosts": [
            {
                "hostid": "30050"
            }
        ]
    },
    "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.