trigger.update
Opis
object trigger.update(object/array triggers)
Ta metoda umożliwia aktualizację istniejących wyzwalaczy.
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 ról użytkowników. Więcej informacji można znaleźć w sekcji Role użytkowników.
Parametry
(object/array) Właściwości wyzwalacza do zaktualizowania.
Właściwość triggerid musi być zdefiniowana dla każdego wyzwalacza, wszystkie pozostałe
właściwości są opcjonalne. Zaktualizowane zostaną tylko przekazane właściwości, wszystkie
pozostałe pozostaną bez zmian.
Oprócz standardowych właściwości wyzwalacza metoda akceptuje następujące parametry.
| Parametr | Type | Opis |
|---|---|---|
| dependencies | array | Wyzwalacze, od których zależy wyzwalacz. W wyzwalaczach musi być zdefiniowana tylko właściwość triggerid. |
| tags | array | Tagi wyzwalacza. |
Wartości zwracane
(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych wyzwalaczy
we właściwości triggerids.
Przykłady
Włączanie wyzwalacza
Włącz wyzwalacz, czyli ustaw jego status na „0”.
{
"jsonrpc": "2.0",
"method": "trigger.update",
"params": {
"triggerid": "13938",
"status": 0
},
"id": 1
}
Odpowiedź:
{
"jsonrpc": "2.0",
"result": {
"triggerids": [
"13938"
]
},
"id": 1
}
Zastępowanie tagów wyzwalacza
Zastąp tagi dla wyzwalacza.
{
"jsonrpc": "2.0",
"method": "trigger.update",
"params": {
"triggerid": "13938",
"tags": [
{
"tag": "service",
"value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"
},
{
"tag": "error",
"value": ""
}
]
},
"id": 1
}
Odpowiedź:
{
"jsonrpc": "2.0",
"result": {
"triggerids": [
"13938"
]
},
"id": 1
}
Zastępowanie zależności
Zastąp zależności dla wyzwalacza.
{
"jsonrpc": "2.0",
"method": "trigger.update",
"params": {
"triggerid": "22713",
"dependencies": [
{
"triggerid": "22712"
},
{
"triggerid": "22772"
}
]
},
"id": 1
}
Odpowiedź:
{
"jsonrpc": "2.0",
"result": {
"triggerids": [
"22713"
]
},
"id": 1
}
Źródło
CTrigger::update() w ui/include/classes/api/services/CTrigger.php.