删除多个Object
更新时间:2021-12-29
接口说明
该命令可以实现通过一个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. |
请求示例
JSON
1POST /v1/bucketName_example/?delete
2<公共请求头>
3
4
5{
6 "objects" : [ {
7 "key" : "my-object2"
8 } ]
9}
响应示例
JSON
1HTTP/1.1 200 OK
2<公共响应头>
3
4{
5 "errors" : [ {
6 "code" : "InvalidArgument",
7 "message" : "Invalid Argument.",
8 "key" : "my-object2"
9 }, {
10 "code" : "InvalidArgument",
11 "message" : "Invalid Argument.",
12 "key" : "my-object2"
13 } ]
14}
错误码
请参考通用错误码