这是本节的多页打印视图。点击此处打印.

返回本页常规视图.

安装软件相关接口

安装软件相关接口，依赖install插件

1: /install/run
2: /install/status

1 - /install/run

安装软件

参数

id: 机器id
uri: 下载uri，可选
url: 下载url，可选
dir: 安装或解压路径，可选
timeout: 超时时间，单位秒，可选，默认300
auth: sudo、su或空值，可选
user: 账号，可选
pass: 密码，可选

返回值

{
  "code": 0,
  "payload": 任务ID
}

错误，未找到机器

{
  "code": 404,
  "msg": "client not found"
}

错误，其他运行时错误

{
  "code": 500,
  "msg": 错误内容
}

说明

dir参数仅当msi、exe或压缩包时有效
url和uri参数必须传一个，且uri参数的优先级高于url参数
目前仅支持deb、rpm、tar、tar.gz、tar.bz2、zip、msi和exe类型的安装包

2 - /install/status

获取安装任务详情

参数

task_id: 任务ID

返回值

{
  "code": 0,
  "payload": {
    "done": 是否完成,
    "actions": [
      {
        "action": 任务类型,
        "name": 名称,
        "time": 时间戳,
        "ok": 是否成功,
        "msg": 失败信息
      }, ...
    ]
  }
}

错误，任务不存在

{
  "code": 404,
  "msg": 错误信息
}

说明

任务类型包含以下几种：
- download: 下载安装包
- install: 安装或解压安装包
- file: 附加文件
- done: 完成
name字段定义：
- download: 安装包下载路径
- install: 安装包下载路径
- file: 附加文件保存路径