目录删除接口
最近更新时间:2018-10-30 11:00:00
接口名称:rmdir
接口url:https://api-ess.xycloud.com/rmdir
描述:删除单个或多个目录及目录下的所有文件(不支持删除 bucket)
字段传递方式:Json 格式内容传递
请求参数
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
bucket | string | 必须 | bucket 桶 |
uri | string数组 | 必须 | 需要删除的目录列表 |
ak | string | 必须 | 用户创建时返回的 ak / sk ,用于 token 验证 |
token | string | 必须 | 用户token值,生成规则:token=MD5(bucket + urilist + ak + sk + timestamp) 其中 urilist 为 uri 中文件夹列表的拼接,如示例中的 token 为 MD5("apitest.com/adtestabc1231533643920"),其中 sk 设置为 abc123 |
timestamp | string | 必须 | UTC 时间秒数的字符串,用户 token 验证及 uri 过期检测 |
返回参数
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
errno | int32 | 必须 | 查询结果:0 成功,其他失败 |
reason | string | 必须 | 结果说明 |
示例
请求示例
POST /rmdir HTTP/1.1
Host: api-ess.xycloud.com
Connection: keep-alive
Accept-Encoding: gzip, deflate
Accept: */*
User-Agent: python-requests/2.19.1
Content-Length: 160
{"timestamp": "1537348598", "ak": "ak", "bucket": "bucket", "uri": ["test/abc"], "token": "f2b816aaebe12a581d66ae5d31c82473"}
返回示例
HTTP/1.1 200 OK
Date: Wed, 19 Sep 2018 09:16:37 GMT
Content-Length: 30
Content-Type: text/plain; charset=utf-8
{"errno":0,"reason":"success"}