usermacro.update

Opis

object usermacro.update(object/array hostMacros)

Ta metoda umożliwia aktualizowanie istniejących makr hosta.

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

Parametry

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

Właściwość hostmacroid musi być zdefiniowana dla każdego makra hosta, wszystkie pozostałe właściwości są opcjonalne. Zaktualizowane zostaną tylko przekazane właściwości, wszystkie pozostałe pozostaną bez zmian.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych makr hosta we właściwości hostmacroids.

Przykłady

Zmiana wartości makra hosta

Zmień wartość makra hosta na „public”.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "usermacro.update",
    "params": {
        "hostmacroid": "1",
        "value": "public"
    },
    "id": 1
}

Odpowiedź:

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

Zmień wartość makra utworzonego przez regułę wykrywania

Zmień utworzone przez regułę wykrywania makro „automatic” na „manual” i zmień jego wartość na „new-value”.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "usermacro.update",
    "params": {
        "hostmacroid": "1",
        "value": "new-value",
        "automatic": "0"
    },
    "id": 1
}

Odpowiedź:

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

Źródło

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