接口描述

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

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

请求（Request）

• 请求语法

    POST /?delete HTTP/1.1
    Host: <BucketName>.bj.bcebos.com
    Date: <Date>
    Authorization: <AuthorizationString>
    Content-Length: <ContentLength>
    Content-Type: text/plain
  
    {
        "objects": [
            {
                "key": "my-object1"
            },
            {
                "key": "my-object2"
            }
        ]
    }

• 请求头域

  无特殊Header参数

• 请求参数

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

响应（Response）

• 响应头域

  无特殊Header参数返回

• 响应参数

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

示例

• 请求示例

    POST /?delete HTTP/1.1
    Host: <BucketName>.bj.bcebos.com
    Date: Wed, 06 Apr 2016 06:34:40 GMT
    Authorization: AuthorizationString
    Content-Length: 11434
    Content-Type: text/plain
  
    {
        "objects": [
            {
                "key": "my-object1"
            },
            {
                "key": "my-object2"
            }
         ]
    }

• 响应示例

    HTTP/1.1 200 OK
    x-bce-request-id : 4db2b34d-654d-4d8a-b49b-3049ca786409
    Date: Wed, 06 Apr 2016 06:34:40 GMT
    Connection: close
    Content-Length: 1324
    Server: BceBos
  
    {
        "errors": [
            {
                "key": "my-object1",
                "code": "NoSuchKey",
                "message": "The specified key does not exist."
            },
            {
                "key": "my-object2",
                "code": "InvalidArgument",
                "message": "Invalid Argument."
            }
        ]
    }