删除多个对象
更新时间 2024-08-20 11:16:33
最近更新时间: 2024-08-20 11:16:33
此接口用于删除同一个存储桶中的多个对象。
接口功能介绍
此接口用于删除同一个存储桶中的多个对象。
接口约束
无
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 | 当前资源池暂不支持批量删除对象操作 |
错误码
请参考 请求错误码（原生接口）。
