所有文档

          对象存储 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