triggerprototype.update

Beschreibung

object triggerprototype.update(object/array triggerPrototypes)

Mit dieser Methode können vorhandene Auslöser-Prototypen aktualisiert werden.

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 Eigenschaften des Auslöser-Prototyps.

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

Zusätzlich zu den Standard-Eigenschaften des Auslöser-Prototyps akzeptiert die Methode die folgenden Parameter.

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

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

Rückgabewerte

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

Beispiele

Aktivieren eines Auslöser-Prototyps

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

Anfrage:

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

Antwort:

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

Ersetzen von Tags eines Auslöser-Prototyps

Ersetzen Sie die Tags für einen Auslöser-Prototyp.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "triggerprototype.update",
    "params": {
        "triggerid": "17373",
        "tags": [
            {
                "tag": "volume",
                "value": "{#FSNAME}"
            },
            {
                "tag": "type",
                "value": "{#FSTYPE}"
            }
        ]
    },
    "id": 1
}

Antwort:

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

Quelle

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