功能描述

此接口用于批量删除桶中的多个对象，每次最多能够删除 1000 条。

在开启版本控制的桶中，在调用 DeleteMultiObjects 接口来批量删除对象时，如果在 Delete 请求中未指定versionId，将插入删除标记。如果指定了versionId，将永久删除该对象的指定版本。

批量删除对象支持的响应方式可以通过quiet进行设置。quiet为false时，是指在返回响应时，不管对象是否删除成功都将删除结果包含在响应里；quiet为true时，是指在返回响应时，只返回删除失败的对象结果，没有返回的认为删除成功。

请求消息样式

请求参数和消息头

该请求的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
delete	Query	String	是	-	代表 DeleteMultipleObjects 请求的特殊标识。
Content-MD5	Header	String	是	dgWRtDmbPCHa/IS1s7XxUg==	将 DeleteMultipleObjects 的请求消息体经过 Base64MD5 加密后得到的字符串的值。
recursive	Query	String	否	true	递归删除非空目录。取值为 true 时，表示该功能生效，不传或传 false 时不递归删除。说明如下：删除文件携带 recursive，则忽略该字段。开启回收站后，删除非空目录必须携带 recursive。警告该参数仅支持在开启回收站功能的分层命名空间使用，回收站功能详情请参见回收站。
skipTrash	Query	String	否	true	是否跳过回收站彻底删除，取值说明如下： true：表示跳过回收站彻底删除。 false：表示不跳过回收站，删除的对象会先进入回收站。警告该参数仅支持在开启回收站功能的分层命名空间使用，回收站功能详情请参见回收站。

请求元素

名称	参数类型	是否必选	示例值	说明
Objects	Array	是	-	待删除对象列表根节点。
Key	String	是	objectName	待删除对象名。父节点为 Objects。
VersionId	String	否	57AF1A32CECB56721267	待删除对象版本号，可通过列举对象接口获取。父节点为 Objects。
Quiet	Bool	否	false	批删之后响应模式，取值说明如下： false：删除结果包含在响应体中返回，默认值。 true：只返回删除失败的结果。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

请求示例 1

批量删除 obj1 和 obj2。

响应示例 1

成功响应示例：

失败响应示例：

请求示例 2

如果从多版本开启的桶中删除对象，未指定 VersionId，因此为其插入删除标记。

响应示例 2

开启多版本的桶，未指定 VersionId，对象删除成功响应消息。

请求示例 3

如果从多版本开启的桶中删除对象，指定 VersionId 删除。

响应示例 3

开启多版本的桶，指定 VersionId，对象删除成功响应消息。

请求示例4

该示例展示，批量删除对象，返回结果中同时包含成功和失败的对象。在如下示例中，该请求者没有删除对象 obj2 的权限。

响应示例4

响应消息中，Deleted 表示删除成功的对象，Error 表示删除失败的对象。

请求示例 5

开启回收站后，携带 recursive=true 递归删除目录 dir1/ 和 dir2/，dir1/ 和 dir2/ 进入回收站，其在回收站中的路径分别为 .Trash/20250321073000/dir1/、.Trash/20250321073000/dir2/。

响应示例 5

请求示例 6

开启回收站后，携带 skipTrash=true 跳过回收站删除文件 file1 和 file2，file1 和 file2 被彻底删除。

响应示例 6