接口描述

该命令可以实现通过一个HTTP请求删除同一个Bucket下的多个Object。

• 支持一次请求内最多删除1000个Object。
• 消息体（body）不超过2M。
• 返回的消息体中只包含删除过程中出错的Object结果；如果所有Object都删除都成功的话，则没有消息体。

请求（Request）

• 请求语法

  Plain Text 复制

  1  POST /?delete HTTP/1.1
  2  Host: <BucketName>.bj.bcebos.com
  3  Date: <Date>
  4  Authorization: <AuthorizationString>
  5  Content-Length: <ContentLength>
  6  Content-Type: text/plain
  7
  8  {
  9      "objects": [
  10          {
  11              "key": "my-object1"
  12          },
  13          {
  14              "key": "my-object2"
  15          }
  16      ]
  17  }

• 请求头域

  无特殊Header参数

• 请求参数

  参数名称	Query参数	描述	父节点
  objects	Request Body参数	保存要删除的Object信息的容器，里面包含一个或多个Object元素。	-
  +key	Request Body参数	要删除的Object名称。	objects

响应（Response）

• 响应头域

  无特殊Header参数返回

• 响应参数

  参数名称	描述	父节点
  errors	删除过程中出错的Object信息的容器，里面包含一个或多个Object元素。	-
  +key	删除出错的Object名称。	errors
  +code	错误代码。	errors
  +message	错误信息。	errors

示例

• 请求示例

  Plain Text 复制

  1  POST /?delete HTTP/1.1
  2  Host: <BucketName>.bj.bcebos.com
  3  Date: Wed, 06 Apr 2016 06:34:40 GMT
  4  Authorization: AuthorizationString
  5  Content-Length: 11434
  6  Content-Type: text/plain
  7
  8  {
  9      "objects": [
  10          {
  11              "key": "my-object1"
  12          },
  13          {
  14              "key": "my-object2"
  15          }
  16       ]
  17  }

• 响应示例

  Plain Text 复制

  1  HTTP/1.1 200 OK
  2  x-bce-request-id : 4db2b34d-654d-4d8a-b49b-3049ca786409
  3  Date: Wed, 06 Apr 2016 06:34:40 GMT
  4  Connection: close
  5  Content-Length: 1324
  6  Server: 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  }