trigger.create

Beschreibung

object trigger.create(object/array triggers)

Mit dieser Methode können neue Auslöser erstellt werden.

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

Parameter

(object/array) Zu erstellende Auslöser.

Zusätzlich zu den Standard-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 erstellten Auslöser unter der Eigenschaft triggerids enthält. Die Reihenfolge der zurückgegebenen IDs entspricht der Reihenfolge der übergebenen Auslöser.

Beispiele

Erstellen eines Auslösers

Erstellen Sie zwei Auslöser, die jeweils von einem anderen Auslöser abhängen.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "trigger.create",
    "params": [
        {
            "description": "Die Prozessorlast ist auf {HOST.NAME} zu hoch",
            "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5",
            "dependencies": [
                {
                    "triggerid": "17367"
                }
            ]
        },
        {
            "description": "Dienst wurde gestoppt",
            "expression": "length(last(/Linux server/log[/var/log/system,Service .* has stopped]))<>0",
            "dependencies": [
                {
                    "triggerid": "17368"
                }
            ],
            "tags": [
                {
                    "tag": "service",
                    "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"
                },
                {
                    "tag": "error",
                    "value": ""
                }
            ]
        }
    ],
    "id": 1
}

Antwort:

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

Quelle

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