RestartRobot
启动(重启)当前账号下的一个实盘,可以同时用新的配置替换原配置;启动会扣费。
示例
按实盘当前的配置启动实盘123。
python
# api() 见「签名验证」页面的Python示例
r = api('RestartRobot', 123)
print(r['data']['result']) # 输出:0(准备中,启动流程已执行完)返回值
| 类型 | 描述 |
number |
|
参数
| 名称 | 类型 | 必填 | 描述 |
robotId | number | 是 | 实盘Id,可以用 |
settings | object | 否 | 新的实盘配置,传入时整份覆盖原配置再启动,见备注;字段见 |
备注
在平台页面创建、使用已添加交易所账户(pid)的实盘,可以只传robotId,按实盘当前的配置启动。用eid方式直接传入交易所配置的实盘(通常由扩展API接口创建),平台没有保存密钥,每次重启都必须传入settings。
传入settings时,先用它整份覆盖实盘的配置(名称、参数、交易所、K线周期、托管者),再启动;不能更换策略。没有写的字段不会保留原值:name变为空字符串,args变为[](参数全部恢复默认值),没写exchanges会删除实盘的全部交易所配置,period变为60秒,node变为自动分配;只有group不写或为0时保留原分组。所以传入settings时必须写出完整配置,建议先用GetRobotDetail取得当前配置再修改。
实盘处于准备中、运行中或停止中时传入settings,返回code为6的错误(robot is running);不传settings时不会重新启动,直接返回当前的状态码(0、1、2)。
返回负数表示启动失败,含义见实盘状态码中的「启动失败的返回值」。启动后实盘是运行中,还是因编译出错等进入「策略有错误」,要用GetRobotDetail查询。