更新

描述

object script.update(object/array scripts)

此方法允许更新已存在的脚本。

此方法只有_超级管理员_ 用户可以使用。可以在用户角色设置中撤销调用此方法的权限。 更多信息见 User roles

参数

(object/array) 待更新的脚本属性

所有脚本必须定义scriptid属性，其他所有属性都是可选的。只有被传递的属性会被更新，其他所有属性保持不变。例外是type属性会从5（Webhook）变成其他：parameters属性会被清除。

返回值

(object) 返回一个scriptids属性包含被更新脚本ID的对象。

示例

修改脚本命令

把脚本命令修改为“/bin/ping -c 10 {HOST.CONN} 2>&1”。 请求:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "script.update",
  4.            "params": {
  5.                "scriptid": "1",
  6.                "command": "/bin/ping -c 10 {HOST.CONN} 2>&1"
  7.            },
  8.            "id": 1
  9.        }

响应

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": {
  4.                "scriptids": [
  5.                    "1"
  6.                ]
  7.            },
  8.            "id": 1
  9.        }

更改脚本命令并添加手动输入

改变脚本命令”/bin/ping -c {MANUALINPUT} {HOST.CONN} 2>&1”. 请求:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "script.update",
  4.            "params": {
  5.              "scriptid": "1",
  6.              "command": "/bin/ping -c {MANUALINPUT} {HOST.CONN} 2>&1",
  7.              "manualinput": "1",
  8.              "manualinput_prompt": "Specify the number of ICMP packets to send with the ping command",
  9.              "manualinput_validator": "^(?:[1-9]|10)$",
  10.              "manualinput_validator_type": "0",
  11.              "manualinput_default_value": "10"
  12.            },
  13.            "id": 1
  14.        }

响应:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": {
  4.                "scriptids": [
  5.                    "1"
  6.                ]
  7.            },
  8.            "id": 1
  9.        }

源代码

CScript::update() 在 frontends/php/include/classes/api/services/CScript.php。