hostgroup.update

Opis

object hostgroup.update(object/array hostGroups)

Ta metoda umożliwia aktualizację istniejących grup hostów.

Ta metoda jest dostępna tylko dla użytkowników typu Admin i Super admin. Uprawnienia do wywołania metody mogą być cofnięte w ustawieniach ról użytkownika. Zobacz Role użytkownika aby uzyskać więcej informacji.

Parametry

(object/array) Właściwości grupy hostów, które mają zostać zaktualizowane.

Właściwość groupid musi być zdefiniowana dla każdej grupy hostów, wszystkie pozostałe właściwości są opcjonalne. Zaktualizowane zostaną tylko podane właściwości, wszystkie pozostałe pozostaną bez zmian.

Zwracane wartości

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

Przykłady

Zmiana nazwy grupy hostów

Zmień nazwę grupy hostów na „Linux hosts”.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.update",
    "params": {
        "groupid": "7",
        "name": "Linux hosts"
    },
    "id": 1
}

Odpowiedź:

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

Zmiana nazw wielu grup hostów

Zmień nazwy dwóch grup hostów, aby uwzględnić w nich informacje o regionie.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.update",
    "params": [
        {
            "groupid": "8",
            "name": "Europe/Linux hosts"
        },
        {
            "groupid": "9",
            "name": "Europe/Windows hosts"
        }
    ],
    "id": 1
}

Odpowiedź:

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

Źródło

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