usermacro.update
Opis
object usermacro.update(object/array hostMacros)
Ta metoda umożliwia aktualizację istniejących makr hosta.
Ta metoda jest dostępna tylko dla użytkowników typu Admin i Super admin. Uprawnienia do wywołania tej metody mogą zostać cofnięte 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”.
{
"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”.
{
"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.