DeleteMultipleObjects
更新时间：2026-09-18
接口描述
该接口可以通过一个 HTTP 请求删除同一个 Bucket 下的多个 Object。
- 支持一次请求内最多删除 1000 个 Object。
- 消息体（Body）不超过 2 MB。
- 返回的消息体中只包含删除过程中出错的 Object 结果；如果所有 Object 都删除成功，则没有消息体。
- 调用该接口需要在请求头中携带
Authorization签名信息。
请求
请求结构
Http
1POST /?delete HTTP/1.1
2Host: {BucketName}.bj.bcebos.com
3Date: {Date}
4Authorization: {AuthorizationString}
5Content-Length: {ContentLength}
6Content-Type: text/plain
7
8{
9 "objects": [
10 {
11 "key": "{ObjectKey1}"
12 },
13 {
14 "key": "{ObjectKey2}"
15 }
16 ]
17}请求头域
无特殊 Header 参数。
请求参数
| 参数名称 | 类型 | 位置 | 必填 | 父节点 | 说明 |
|---|---|---|---|---|---|
| delete | String | Query | 是 | - | 批量删除操作标识。该参数为空值，HTTP 客户端需要保留该查询项，例如 ?delete 或 ?delete=。 |
| objects | Array<Object> | Body | 是 | - | 保存要删除的 Object 信息的容器，里面包含 1~1000 个 Object 元素。 |
| key | String | Body | 是 | objects | 要删除的 Object 名称。 |
响应
响应头域
无特殊 Header 参数返回。
响应参数
| 参数名称 | 类型 | 是否必返 | 父节点 | 说明 |
|---|---|---|---|---|
| errors | Array<Object> | 否 | - | 删除过程中出错的 Object 信息的容器，里面包含一个或多个 Object 元素。所有 Object 删除成功时，响应体为空。 |
| key | String | 是 | errors | 删除出错的 Object 名称。 |
| code | String | 是 | errors | 错误代码。 |
| message | String | 是 | errors | 错误信息。 |
示例
请求示例
Http
1POST /?delete HTTP/1.1
2Host: <BucketName>.bj.bcebos.com
3Date: Wed, 06 Apr 2016 06:34:40 GMT
4Authorization: AuthorizationString
5Content-Length: 131
6Content-Type: text/plain
7
8{
9 "objects": [
10 {
11 "key": "my-object1"
12 },
13 {
14 "key": "my-object2"
15 }
16 ]
17}响应示例
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
3Date: Wed, 06 Apr 2016 06:34:40 GMT
4Connection: close
5Content-Length: 1324
6Server: BceBos
7
8{
9 "errors": [
10 {
11 "key": "my-object1",
12 "code": "NoSuchKey",
13 "message": "The specified key does not exist."
14 },
15 {
16 "key": "my-object2",
17 "code": "InvalidArgument",
18 "message": "Invalid Argument."
19 }
20 ]
21}评价此篇文章