trigger.update

Beschreibung

object trigger.update(object/array triggers)

Diese Methode ermöglicht die Aktualisierung vorhandener Auslöser.

Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) Zu aktualisierende Auslöser-Eigenschaften.

Die Eigenschaft triggerid muss für jeden Auslöser definiert sein, alle anderen Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle anderen bleiben unverändert.

Zusätzlich zu den standardmäßigen Auslöser-Eigenschaften akzeptiert die Methode die folgenden Parameter.

Parameter Type Beschreibung
dependencies array Auslöser, von denen der Auslöser abhängig ist.

Für die Auslöser darf nur die Eigenschaft triggerid definiert sein.
tags array Auslöser-Tags.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Auslöser unter der Eigenschaft triggerids enthält.

Beispiele

Einen Auslöser aktivieren

Aktivieren Sie einen Auslöser, d. h. setzen Sie seinen Status auf „0“.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "trigger.update",
    "params": {
        "triggerid": "13938",
        "status": 0
    },
    "id": 1
}

Antwort:

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

Ersetzen von Auslöser-Tags

Ersetzt Tags für einen Auslöser.

Anfrage:

{
    "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
}

Antwort:

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

Ersetzen von Abhängigkeiten

Ersetzen Sie Abhängigkeiten für den Auslöser.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "trigger.update",
    "params": {
        "triggerid": "22713",
        "dependencies": [
            {
                "triggerid": "22712"
            },
            {
                "triggerid": "22772"
            }
        ]
    },
    "id": 1
}

Antwort:

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

Quelle

CTrigger::update() in ui/include/classes/api/services/CTrigger.php.