Appearance
DeleteMultipleObjects
接口描述
该命令可以实现通过一个HTTP请求删除同一个Bucket下的多个Object。
- 支持一次请求内最多删除1000个Object。
- 消息体（body）不超过2M。
- 返回的消息体中只包含删除过程中出错的Object结果；如果所有Object都删除都成功的话，则没有消息体。
请求（Request）
请求语法
POST /<BucketName>?delete HTTP/1.1
Host: fos.flymeyun.com
Date: <Date>
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 /<BucketName>/?delete HTTP/1.1
Host: fos.flymeyun.com
Date: Wed, 06 Apr 2016 06:34:40 GMT
Content-Length: 11434
Content-Type: text/plain
{
"objects": [
{
"key": "my-object1"
},
{
"key": "my-object2"
}
]
}响应示例
HTTP/1.1 200 OK
x-fos-request-id : 4db2b34d-654d-4d8a-b49b-3049ca786409
Date: Wed, 06 Apr 2016 06:34:40 GMT
Connection: close
Content-Length: 1324
{
"errors": [
{
"key": "my-object1",
"code": "NoSuchKey",
"message": "The specified key does not exist."
},
{
"key": "my-object2",
"code": "InvalidArgument",
"message": "Invalid Argument."
}
]
}