删除文件夹和文件

该接口用于删除文件夹和文件,如果传入的 path/ 结尾,即为删除文件夹,否则为删除文件,该接口不支持删除非空文件夹,如果需要删除非空文件夹,请参考创建删除文件夹任务和查询任务状态 API

删除文件夹

DELETE

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

示例:

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

Query

Required Name Example Description
✔︎ path /data/ 注意以 / 结束

Response

Normal

code = 0

示例:

{
  "code": 0,
  "msg": "",
  // 被删文件夹所在目录的内容(被删文件夹已不存在)
  "infos": [
    {
      "name": "picture.png",
      "size": 126187,
      "createTime": {
        "seconds": 1562642063,
        "nanos": 608753391
      },
      "modTime": {
        "seconds": 1562642063,
        "nanos": 608753391
      },
      "ownerId": 0,
      "isDir": false
    }
  ]
}

Exception

code = 1 || 7 || 15

如果文件夹内有内容,当前返回 code 也为 1
参见 全局错误码

删除文件

DELETE

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

示例:

curl --request DELETE \
  # 注意 path 不以 / 结尾
  --url 'http://matpool.com:30100/v1/fs?path=/<FILENAME>' \
  --header 'Authorization: Bearer <YOUR_TOKEN>' \

Header

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

Query

Required Name Example Description
✔︎ path /data.txt 注意不以 / 结束

Response

Normal

code = 0

示例:

{
  "code": 0,
  "msg": "",
  // 被删文件所在目录的内容(被删文件已不存在)
  "infos": []
}

Exception

code = 1 || 7 || 15

参见 全局错误码

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