目录删除接口

最近更新时间: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"}