trigger.create

Beschreibung

object trigger.create(object/array triggers)

Diese Methode ermöglicht es Ihnen, neue Auslöser zu erstellen.

Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle widerrufen 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.