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

返回本页常规视图.

文件操作相关接口

文件操作相关接口，依赖file插件

1 - /file/download

下载某个节点上的文件

参数

  1. id: 机器id
  2. dir: 文件路径
  3. timeout: 超时事件，默认10分钟

返回值

文件内容

错误，未找到机器或文件

http_code=404
body=(client/file) not found

错误，超时

http_code=408
body=timeout

错误，校验码错误

http_code=409
body=invalid checksum

错误，运行时错误

http_code=503
body=错误内容

2 - /file/ls

查询某个节点上的文件

参数

  1. id: 机器ID
  2. dir: 目录

返回值

{
  "code": 0,
  "payload": {
    "dir": 目录,
    "files": [
      {
        "name": 名称,
        "auth": 权限,
        "user": 所属用户,
        "group": 所属组,
        "size": 文件大小,
        "mod_time": 更新时间戳,
        "is_dir": 是否是目录,
        "is_link": 是否是软链
      }, ...
    ]
  }
}

错误，未找到机器或目录不存在

{
  "code": 404,
  "msg": "(client/directory) not found"
}

错误，超时

{
  "code": 408,
  "msg": "timeout"
}

错误，其他错误

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

3 - /file/upload_from

从指定url上传文件到某个节点

参数

  1. id: 机器id
  2. dir: 保存位置
  3. name: 文件名
  4. uri: 下载uri
  5. auth: sudo、su或空值，可选
  6. user: 账号，可选
  7. pass: 密码，可选
  8. mod: 文件权限，十进制，可选，默认0644
  9. own_user: 文件所属用户
  10. own_group: 文件所属分组
  11. timeout: 超时时间，单位秒，可选，默认60

返回值

{
  "code": 0,
  "payload": {
    "dir": 文件存放路径
  }
}

错误，未找到机器

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

错误，其他运行时错误

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

错误，上传失败

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

错误，文件内容错误

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

4 - /file/upload

上传文件到某个节点

参数

  1. id: 机器id
  2. dir: 保存位置
  3. auth: sudo、su或空值，可选
  4. user: 账号，可选
  5. pass: 密码，可选
  6. mod: 文件权限，十进制，可选，默认0644
  7. own_user: 文件所属用户
  8. own_group: 文件所属分组
  9. file: http标准文件上传字段
  10. timeout: 超时时间，单位秒，可选，默认60
  11. md5: 文件md5，可选

返回值

{
  "code": 0,
  "payload": null
}

错误，未找到机器

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

错误，其他运行时错误

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

错误，上传失败

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

错误，文件内容错误

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