删除多个Object
接口说明
该命令可以实现通过一个HTTP请求删除同一个Bucket下的多个Object。
- 支持一次请求内最多删除1000个Object。
- 消息体（body）不超过2M。
- 返回的消息体中只包含删除过程中出错的Object结果；如果所有Object都删除都成功的话，则没有消息体。
请求URI
POST /v1/{bucketName}/?delete
| 参数名称 |
参数类型 |
是否必须 |
描述 |
示例值 |
参数位置 |
| bucketName |
String |
是 |
bucket的名称 |
"bucketName_example" |
Path |
请求体参数
请求体字段数据结构说明
| 参数名称 |
参数类型 |
是否必须 |
描述 |
示例值 |
| objects |
List<Objects> |
是 |
保存要删除的Object信息的容器，里面包含一个或多个Object元素 |
|
Objects字段数据结构说明
| 参数名称 |
参数类型 |
是否必须 |
描述 |
示例值 |
| key |
String |
否 |
|
my-object2 |
响应体参数
响应体字段数据结构说明
| 参数名称 |
参数类型 |
描述 |
示例值 |
| errors |
List<Errors> |
删除过程中出错的Object信息的容器，里面包含一个或多个Object元素。 |
|
Errors字段数据结构说明
| 参数名称 |
参数类型 |
描述 |
示例值 |
| key |
String |
删除出错的Object名称。 |
my-object2 |
| code |
String |
错误代码。 |
InvalidArgument |
| message |
String |
错误信息。 |
Invalid Argument. |
请求示例
POST /v1/bucketName_example/?delete
<公共请求头>
{
"objects" : [ {
"key" : "my-object2"
} ]
}
响应示例
HTTP/1.1 200 OK
<公共响应头>
{
"errors" : [ {
"code" : "InvalidArgument",
"message" : "Invalid Argument.",
"key" : "my-object2"
}, {
"code" : "InvalidArgument",
"message" : "Invalid Argument.",
"key" : "my-object2"
} ]
}
错误码
请参考通用错误码
