删除文件夹和文件
该接口用于删除文件夹和文件,如果传入的 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>'
Header
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
参见 全局错误码