script.update

Beschreibung

object script.update(object/array scripts)

Diese Methode ermöglicht die Aktualisierung vorhandener Skripte.

Diese Methode ist nur für den Benutzertyp Super admin verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Siehe Benutzerrollen für weitere Informationen.

Parameter

(object/array) zu aktualisierende Skript-Eigenschaften.

Die Eigenschaft scriptid muss für jedes Skript definiert sein, alle anderen Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle anderen bleiben unverändert. Eine Ausnahme ist die Änderung der Eigenschaft type von 5 (webhook) zu einem anderen Wert: Die Eigenschaft parameters wird geleert.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Skripte unter der Eigenschaft scriptids enthält.

Beispiele

Skriptbefehl ändern

Ändern Sie den Befehl des Skripts in „/bin/ping -c 10 {HOST.CONN} 2>&1“.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "script.update",
    "params": {
        "scriptid": "1",
        "command": "/bin/ping -c 10 {HOST.CONN} 2>&1"
    },
    "id": 1
}

Antwort:

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

Skriptbefehl ändern und manuelle Eingabe hinzufügen

Ändern Sie den Befehl des Skripts in "/bin/ping -c {MANUALINPUT} {HOST.CONN} 2>&1".

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "script.update",
    "params": {
      "scriptid": "1",
      "command": "/bin/ping -c {MANUALINPUT} {HOST.CONN} 2>&1",
      "manualinput": "1",
      "manualinput_prompt": "Geben Sie die Anzahl der ICMP-Pakete an, die mit dem ping-Befehl gesendet werden sollen",
      "manualinput_validator": "^(?:[1-9]|10)$",
      "manualinput_validator_type": "0",
      "manualinput_default_value": "10"
    },
    "id": 1
}

Antwort:

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

Quelle

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