创建删除文件夹任务和查询任务状态

该接口用于创建一个删除文件夹任务以及查询任务状态

创建删除文件夹任务

DELETE

接口路径:http://matpool.com:30100/v1/fs/delete_dir

示例:

curl --request DELETE \
  --url 'http://matpool.com:30100/v1/fs/delete_dir?dir=/data' \
  --header 'Authorization: Bearer <YOUR_TOKEN>'
Required Name Value Description
✔︎ Authorization Bearer <token> 用户鉴权

Query

Required Name Example Description
✔︎ dir /data 待删除的文件夹的完整路径

注意:该接口调用需要特殊权限,如需开通请联系矩池云客服。

Response

Normal

code = 0

示例:

{
    "code": 0,
    "msg": "",
    "deleteDir": {
        "id": 25,            // 删除文件夹任务id,可以根据该id查询任务状态
        "dir": "easy-rsa",
        "status": 1,         // 任务当前状态:1, 等待中;2, 删除中;3, 已完成。
        "comment": ""        // 如果删除失败,返回失败原因
    }
}

Exception

code = 1 || 7

参见 全局错误码

查询删除任务

GET

接口路径:http://matpool.com:30100/v1/fs/delete_dir

示例:

curl --request GET \
  --url 'http://matpool.com:30100/v1/fs/delete_dir?id=1' \
  --header 'Authorization: Bearer <YOUR_TOKEN>'

Header

Required Name Value Description
✔︎ Authorization Bearer <token> 用户鉴权

Query

Required Name Example Description
✔︎ id 1 删除文件夹任务id

Response

Normal

code = 0

示例:

{
    "code": 0,
    "msg": "",
    "deleteDir": {
        "id": 25,            // 删除文件夹任务id,可以根据该id查询任务状态
        "dir": "easy-rsa",
        "status": 1,         // 任务当前状态:1, 等待中;2, 删除中;3, 已完成。
        "comment": ""        // 如果删除失败,返回失败原因
    }
}

Exception

code = 1 || 7

参见 全局错误码

上次修改: 2019-12-02 13:51