triggerprototype.update

Beschreibung

object triggerprototype.update(object/array triggerPrototypes)

Diese Methode ermöglicht es Ihnen, vorhandene Auslöservorlagen zu aktualisieren.

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 widerrufen 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.