对象存储BOS

    DeleteMultipleObjects

    接口描述

    该命令可以实现通过一个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."
                }
            ]
        }  
    上一篇
    DeleteObject
    下一篇
    AppendObject