接口介绍
此接口用于删除同一个存储桶（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 | 指定的桶不存在。 |
