接口介绍
此接口用于删除同一个存储桶（Bucket）中的多个对象（Object）。
接口约束
无
请求URI
POST /v1/{bucket}
路径参数
| 参数 |
是否必填 |
参数类型 |
说明 |
示例 |
| bucket |
是 |
String |
桶名称。 |
testBucket |
Query参数
| 参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
| delete |
是 |
String |
固定参数。 |
delete |
|
注： 如果query中的参数为固定参数，可以传参数名或传空。
请求参数
请求头header参数
| 参数 |
是否必填 |
参数类型 |
说明 |
示例 |
下级对象 |
| Content-Type |
是 |
String |
消息体格式。 |
application/xml |
|
此接口涉及的其他公共请求头，例如Host、Date等的更多信息，请参见公共HTTP头。
请求体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 /v1/testbucket?delete HTTP/1.1
请求头header
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 |
操作成功。 |
| 400 |
当前资源池暂不支持批量删除对象操作。 |
| 403 |
用户没有权限执行操作。 |
| 200 |
指定的桶不存在。 |
