script.update
説明
object script.update(object/array scripts)
このメソッドは、既存のスクリプトを更新するためのものです。
このメソッドはスーパ管理者ユーザータイプでのみ利用可能です。 このメソッドを呼び出す権限は、ユーザーロールの設定で取り消すことができます。詳細はユーザーロールを参照してください。
パラメータ
(object/array) スクリプトのプロパティが更新されます。
scriptidプロパティはスクリプトごとに定義する必要があり、すべてのプロパティはオプションです。 渡されたプロパティのみが更新され、他のプロパティは変更されません。 例外はtypeプロパティが5(Webhook)からその他に変更された場合です。その場合はparametersプロパティはクリーンアップされます。
戻り値
(object) scriptidsプロパティの下で更新されたスクリプトのIDを含むオブジェクトを返します。
例
スクリプトコマンドの変更
スクリプトのコマンドを"/bin/ping -c 10 {HOST.CONN} 2>&1"に変更します。
{
"jsonrpc": "2.0",
"method": "script.update",
"params": {
"scriptid": "1",
"command": "/bin/ping -c 10 {HOST.CONN} 2>&1"
},
"id": 1
}
レスポンス:
{
"jsonrpc": "2.0",
"result": {
"scriptids": [
"1"
]
},
"id": 1
}
スクリプトコマンドを変更して、手動入力を追加します
スクリプトのコマンドを "/bin/ping -c {MANUALINPUT} {HOST.CONN} 2>&1" に変更します。
{
"jsonrpc": "2.0",
"method": "script.update",
"params": {
"scriptid": "1",
"command": "/bin/ping -c {MANUALINPUT} {HOST.CONN} 2>&1",
"manualinput": "1",
"manualinput_prompt": "Specify the number of ICMP packets to send with the ping command",
"manualinput_validator": "^(?:[1-9]|10)$",
"manualinput_validator_type": "0",
"manualinput_default_value": "10"
},
"id": 1
}
Response:
{
"jsonrpc": "2.0",
"result": {
"scriptids": [
"1"
]
},
"id": 1
}
ソース
CScript::update() in ui/include/classes/api/services/CScript.php.