Delete Objects

Delete Objects

批量删除对象特性用于将一个桶内的部分对象一次性删除，删除后不可恢复。批量删除对象要求返回结果里包含每个对象的删除结果。的批量删除对象使用同步删除对象的方式，每个对象的删除结果返回给请求用户。

请求语法

登录后复制POST /?delete HTTP/1.1
Host: Bucket.s3-us-east-1.ossfiles.com

POST /?delete HTTP/1.1 Host: Bucket.s3-us-east-1.ossfiles.com

---

URI 请求参数

该请求没有URI请求参数。

名称	描述	类型
Bucket	存储桶名称	字符串
Key	对象名称	字符串

---

请求消息头

该请求没有请求消息头。

---

请求正文

登录后复制<?xml version="1.0" encoding="UTF-8"?>
<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <Object>
      <Key>string</Key>
   </Object>
   <Quiet>boolean</Quiet>
</Delete>

<?xml version="1.0" encoding="UTF-8"?> <Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Object> <Key>string</Key> </Object> <Quiet>boolean</Quiet> </Delete>

---

请求元素

名称	描述	类型
Delete	待删除的对象列表。	容器
Object	待删除的对象。	字符串
Key	待删除的对象Key。	字符串
Quiet	用于指定使用quiet模式，只返回删除失败的对象结果；如果有此字段，则必被置为True，如果为False则被系统忽略掉。	容器

---

响应语法

登录后复制HTTP/1.1 200

<?xml version="1.0" encoding="UTF-8"?>
<DeleteResult>
   <Deleted>
      <DeleteMarker>boolean</DeleteMarker>
      <Key>string</Key>
   </Deleted>
   <Error>
      <Code>string</Code>
      <Key>string</Key>
      <Message>string</Message>
   </Error>
</DeleteResult>

HTTP/1.1 200 <?xml version="1.0" encoding="UTF-8"?> <DeleteResult> <Deleted> <DeleteMarker>boolean</DeleteMarker> <Key>string</Key> </Deleted> <Error> <Code>string</Code> <Key>string</Key> <Message>string</Message> </Error> </DeleteResult>

---

响应元素

名称	描述	类型
DeleteResult	批删响应的根节点。	容器
Deleted	删除成功结果的Container。	容器
Deleted.DeleteMarker	当批量删除请求访问的桶是多版本桶时，如果创建或删除一个删除标记，返回消息中该元素的值为true。	逻辑型
Deleted.Key	每个删除结果的对象名。	字符串
Error	删除失败结果的Container。	容器
Error.Code	删除失败结果的错误码。	字符串
Error.Key	每个删除结果的对象名。	字符串
Error.Message	删除失败结果的错误消息。	字符串

---

响应消息头

该请求没有响应消息头。

---

示例

请求示例

登录后复制POST /?delete HTTP/1.1
Authorization: AWS4-HMAC-SHA256 Credential=2421a691b4ed625de19f6f92677b6459/20230117/us-east-1/s3/aws4_request, SignedHeaders=content-md5;host;x-amz-content-sha256;x-amz-date, Signature=c658f10bedff8e854e18b2e15d3de734c22e1ba97744cd123d8a9d159f7da341
Content-md5: 3bdVD/gv5F4bxtL9UU10jA==
Content-type: application/octet-stream
Host: bucket.s3-us-east-1.ossfiles.com
X-amz-content-sha256: 217f607b037b7c01099deb280ae7096cf0f9f59e68fef8c37f58dd0c6c0c5a2a
X-amz-date: 20230117T101017Z

<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Object>
        <Key>deleteObject_test</Key>
    </Object>
    <Object>
        <Key>deleteObject_test1</Key>
    </Object>
    <Quiet>false</Quiet>
</Delete>

POST /?delete HTTP/1.1 Authorization: AWS4-HMAC-SHA256 Credential=2421a691b4ed625de19f6f92677b6459/20230117/us-east-1/s3/aws4_request, SignedHeaders=content-md5;host;x-amz-content-sha256;x-amz-date, Signature=c658f10bedff8e854e18b2e15d3de734c22e1ba97744cd123d8a9d159f7da341 Content-md5: 3bdVD/gv5F4bxtL9UU10jA== Content-type: application/octet-stream Host: bucket.s3-us-east-1.ossfiles.com X-amz-content-sha256: 217f607b037b7c01099deb280ae7096cf0f9f59e68fef8c37f58dd0c6c0c5a2a X-amz-date: 20230117T101017Z <Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Object> <Key>deleteObject_test</Key> </Object> <Object> <Key>deleteObject_test1</Key> </Object> <Quiet>false</Quiet> </Delete>

返回示例

登录后复制HTTP/1.1 200 OK
Content-length: 211
Content-type: application/xml
Date: Tue, 17 Jan 2023 10:10:19 GMT
x-amz-id-2: b6bf8729c8a645f6adc84e6e00363b85
x-amz-request-id: fe46a9e950c244ae83b8c6d0f24c3c8b

<?xml version="1.0" encoding="UTF-8"?>
<DeleteResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Deleted>
        <Key>deleteObject_test</Key>
    </Deleted>
    <Deleted>
        <Key>deleteObject_test1</Key>
    </Deleted>
</DeleteResult>

HTTP/1.1 200 OK Content-length: 211 Content-type: application/xml Date: Tue, 17 Jan 2023 10:10:19 GMT x-amz-id-2: b6bf8729c8a645f6adc84e6e00363b85 x-amz-request-id: fe46a9e950c244ae83b8c6d0f24c3c8b <?xml version="1.0" encoding="UTF-8"?> <DeleteResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Deleted> <Key>deleteObject_test</Key> </Deleted> <Deleted> <Key>deleteObject_test1</Key> </Deleted> </DeleteResult>