接口功能介绍
此接口用于删除同一个存储桶中的多个对象。
接口约束
无
URI
POST /{bucket}?delete
路径参数
参数 |
是否必填 |
参数类型 |
说明 |
示例 |
bucket |
是 |
String |
桶名称 |
testBucket |
Query参数
参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
delete |
是 |
String |
固定参数 |
delete |
|
请求参数
请求头header参数
参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
Content-Type |
是 |
String |
消息体格式 |
application/xml |
|
Authorization |
是 |
String |
用于验证请求合法性的认证信息 |
|
|
请求体body参数
参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
Delete |
是 |
Array of Objects |
保存DeleteMultipleObjects请求信息 |
|
Delete |
Quiet |
否 |
Boolean |
是否使用简单响应模式请求批量删除。如果为true,则响应中不返回消息体。如果为false,则响应中的消息体包含全部删除对象的结果。不填默认是false |
false |
|
表 Delete
参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
Object |
是 |
Array of Objects |
保存一个对象信息 |
|
Object |
表 Object
参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
Key |
是 |
String |
删除的对象名称 |
test |
|
响应参数
参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
DeleteResult |
是 |
Array of Objects |
保存DeleteMultipleObjects请求结果的容器 |
-- |
DeleteResult |
表 DeleteResult
参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
Deleted |
是 |
Array of Objects |
保存被成功删除的对象的容器 |
|
Key |
Error |
是 |
Array of Objects |
保存被删除失败的对象的容器 |
|
Code,Key,Message |
表 Deleted
参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
Key |
是 |
String |
删除对象的名称 |
1.jpg |
|
表 Error
参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
Key |
是 |
String |
删除失败对象的名称 |
1.jpg |
|
Code |
是 |
String |
删除失败错误码 |
403 |
|
Message |
是 |
String |
删除失败错误信息 |
AccessDenied |
|
请求示例
POST /testbucket?delete HTTP/1.1
请求头header
Authorization: authorization string
Content-Type: applicaton/xml
请求体body
<?xml version="1.0" encoding="UTF-8"?>
<Delete>
<Quiet>false</Quiet>
<Object>
<Key>multipart.data</Key>
</Object>
<Object>
<Key>test.jpg</Key>
</Object>
</Delete>
响应示例
HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<DeleteResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Deleted>
<Key>multipart.data</Key>
</Deleted>
<Deleted>
<Key>test.jpg</Key>
</Deleted>
</DeleteResult>
状态码
状态码 |
错误码 |
描述 |
200 |
|
操作成功 |
403 |
AccessDenied |
用户没有权限执行操作 |
404 |
NoSuchBucket |
指定的桶不存在 |
405 |
MethodNotAllowed |
当前资源池暂不支持批量删除对象操作 |
错误码
请参考 请求错误码(原生接口)。