对象存储

动态与公告

产品简介

购买指南

快速入门

控制台指南

工具指南

最佳实践

视频教程专区

开发者指南

第三方教程

数据湖存储

数据处理 Demo 体验

故障处理

API 文档

SDK 文档

常见问题

服务等级协议

附录

联系我们

词汇表
文档捉虫大赛火热进行中，好礼多多> HOT
文档中心 > 对象存储 > API 文档 > Object 接口 > 基本操作 > DELETE Multiple Objects

DELETE Multiple Objects

最近更新时间：2021-07-22 10:19:25

前往 GitHub 编辑 我的收藏

本页目录：

功能描述

DELETE Multiple Objects 接口请求可以批量删除指定存储桶中的多个对象（Object），单次请求支持最多删除1000个对象。对于响应结果，COS 提供 Quiet 模式和 Verbose 模式：

  • Quiet 模式在响应中仅包含删除失败的对象信息和错误信息。
  • Verbose 模式在响应中包含每个对象的删除结果信息。

该 API 的请求者需要对存储桶有写入权限。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

版本控制

当启用版本控制时，该请求操作可以为每一个要删除的对象指定版本 ID，此时将永久删除对象的指定版本或指定删除标记，否则将创建一个删除标记作为指定对象的最新版本。

当针对某个对象的删除操作创建或删除了删除标记，那么该对象的删除结果将同时返回 <DeleteMarker>true</DeleteMarker> 和 <DeleteMarkerVersionId> 元素，代表该请求操作创建或删除了指定对象的删除标记。

当针对某个对象的删除操作永久删除了特定的版本 ID（包括删除标记的版本 ID），那么该对象的删除结果将返回 <VersionId> 元素，代表该请求操作删除的版本 ID。

请求

请求示例

POST /?delete HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Content-Type: application/xml
Content-Length: Content Length
Content-MD5: MD5
Authorization: Auth String

[Request Body]

说明：

请求参数

此接口无请求参数。

请求头

此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。

请求体

提交 application/xml 请求数据，包含要删除的对象信息。

<Delete>
    <Quiet>boolean</Quiet>
    <Object>
        <Key>string</Key>
    </Object>
    <Object>
        <Key>string</Key>
        <VersionId>string</VersionId>
    </Object>
</Delete>

具体的节点描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
Delete 无 包含 DELETE Multiple Objects 操作的所有请求信息 Container 是

Container 节点 Delete 的内容：

节点名称（关键字） 父节点 描述 类型 是否必选
Quiet Delete 布尔值，默认为 false
  • true 为使用 Quiet 模式，在响应中仅包含删除失败的对象信息和错误信息
  • false 为使用 Verbose 模式，在响应中包含每个对象的删除结果
    		•  boolean 是
    Object Delete 单个要删除的目标对象的信息 Container 是

    Container 节点 Object 的内容：

    节点名称（关键字） 父节点 描述 类型 是否必选
    Key                           Delete.Object 要删除的目标对象的对象键 string 是
    VersionId Delete.Object 当启用版本控制并且要删除对象的指定版本时需指定该元素，值为要删除的版本 ID。若未开启版本控制或开启版本控制但需要插入删除标记，则无需指定该元素 string 是

    响应

    响应头

    此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。

    响应体

    请求成功，返回 application/xml 数据，包含删除结果信息。

    <DeleteResult>
    <Deleted>
        <Key>string</Key>
        <DeleteMarker>boolean</DeleteMarker>
        <DeleteMarkerVersionId>string</DeleteMarkerVersionId>
    </Deleted>
    <Deleted>
        <Key>string</Key>
        <VersionId>string</VersionId>
    </Deleted>
    <Deleted>
        <Key>string</Key>
        <DeleteMarker>boolean</DeleteMarker>
        <DeleteMarkerVersionId>string</DeleteMarkerVersionId>
        <VersionId>string</VersionId>
    </Deleted>
    <Error>
        <Key>string</Key>
        <VersionId>string</VersionId>
        <Code>string</Code>
        <Message>string</Message>
    </Error>
</DeleteResult>

    具体的节点描述如下：

    节点名称（关键字） 父节点 描述 类型
    DeleteResult 无 保存 DELETE Multiple Objects 结果的所有信息 Container

    Container 节点 DeleteResult 的内容：

    节点名称（关键字） 父节点 描述 类型
    Deleted DeleteResult 单个删除成功的对象条目，仅当使用 Verbose 模式才会返回该元素 Container
    Error DeleteResult 单个删除失败的对象条目 Container

    Container 节点 Deleted 的内容：

    节点名称（关键字） 父节点 描述 类型
    Key DeleteResult.Deleted 删除成功的对象的对象键 string
    DeleteMarker DeleteResult.Deleted 仅当对该对象的删除创建了一个删除标记，或删除的是该对象的一个删除标记时才返回该元素，布尔值，固定为 true boolean
    DeleteMarkerVersionId DeleteResult.Deleted 仅当对该对象的删除创建了一个删除标记，或删除的是该对象的一个删除标记时才返回该元素，值为创建或删除的删除标记的版本 ID string
    VersionId DeleteResult.Deleted 删除成功的版本 ID，仅当请求中指定了要删除对象的版本 ID 时才返回该元素 string

    Container 节点 Error 的内容：

    节点名称（关键字） 父节点 描述 类型
    Key DeleteResult.Error 删除失败的对象的对象键 string
    VersionId DeleteResult.Error 删除失败的版本 ID，仅当请求中指定了要删除对象的版本 ID 时才返回该元素 string
    Code DeleteResult.Error 删除失败的错误码，用来定位唯一的错误条件和确定错误场景 string
    Message DeleteResult.Error 删除失败的具体错误信息 string

    错误码

    此接口遵循统一的错误响应和错误码，详情请参见 错误码 文档。

    实际案例

    案例一：简单案例

    请求

    POST /?delete HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Tue, 20 Aug 2019 11:59:35 GMT
Content-Type: application/xml
Content-Length: 158
Content-MD5: zUd/xgzNGDrqJMJUOWV2AQ==
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1566302375;1566309575&q-key-time=1566302375;1566309575&q-header-list=content-length;content-md5;content-type;date;host&q-url-param-list=delete&q-signature=82f77c745ca66fe8c5d93274b3fc44fb895c****
Connection: close

<Delete>
    <Quiet>false</Quiet>
    <Object>
        <Key>example-object-1.jpg</Key>
    </Object>
    <Object>
        <Key>example-object-2.jpg</Key>
    </Object>
</Delete>

    响应

    HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 144
Connection: close
Date: Tue, 20 Aug 2019 11:59:35 GMT
Server: tencent-cos
x-cos-request-id: NWQ1YmUwYTdfM2FiMDJhMDlfYzczN18zMGM1****

<DeleteResult>
    <Deleted>
        <Key>example-object-1.jpg</Key>
    </Deleted>
    <Deleted>
        <Key>example-object-2.jpg</Key>
    </Deleted>
</DeleteResult>

    案例二：简单案例（Quiet 模式）

    请求

    POST /?delete HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Tue, 20 Aug 2019 12:12:26 GMT
Content-Type: application/xml
Content-Length: 157
Content-MD5: +iI9kJvM2k/y5y3nHcn8BQ==
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1566303146;1566310346&q-key-time=1566303146;1566310346&q-header-list=content-length;content-md5;content-type;date;host&q-url-param-list=delete&q-signature=16581dcc0ae999ce343488de2449436ee182****
Connection: close

<Delete>
    <Quiet>true</Quiet>
    <Object>
        <Key>example-object-1.jpg</Key>
    </Object>
    <Object>
        <Key>example-object-2.jpg</Key>
    </Object>
</Delete>

    响应

    HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 15
Connection: close
Date: Tue, 20 Aug 2019 12:12:27 GMT
Server: tencent-cos
x-cos-request-id: NWQ1YmUzYWFfMTljMDJhMDlfNTg3ZV8zNDI0****

<DeleteResult/>

    案例三：启用版本控制（创建删除标记）

    请求

    POST /?delete HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Wed, 21 Aug 2019 12:04:03 GMT
Content-Type: application/xml
Content-Length: 100
Content-MD5: MowFtlG7iwK7Wmk79IVXFA==
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1566389043;1566396243&q-key-time=1566389043;1566396243&q-header-list=content-length;content-md5;content-type;date;host&q-url-param-list=delete&q-signature=b1aee84c567b16e5e6c8634c2760a0e5d348****
Connection: close

<Delete>
    <Quiet>false</Quiet>
    <Object>
        <Key>example-object-1.jpg</Key>
    </Object>
</Delete>

    响应

    HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 200
Connection: close
Date: Wed, 21 Aug 2019 12:04:03 GMT
Server: tencent-cos
x-cos-request-id: NWQ1ZDMzMzNfNDhiNDBiMDlfMmIzNzZfMTBh****

<DeleteResult>
    <Deleted>
        <Key>example-object-1.jpg</Key>
        <DeleteMarker>true</DeleteMarker>
        <DeleteMarkerVersionId>MTg0NDUxNzc2ODQ2NjU3ODM4NTc</DeleteMarkerVersionId>
    </Deleted>
</DeleteResult>

    案例四：删除指定版本

    请求

    POST /?delete HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Wed, 21 Aug 2019 11:24:43 GMT
Content-Type: application/xml
Content-Length: 154
Content-MD5: EwFydeQSMzaHWi0qMTOGWw==
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1566386683;1566393883&q-key-time=1566386683;1566393883&q-header-list=content-length;content-md5;content-type;date;host&q-url-param-list=delete&q-signature=2b6261e526960a433124b752fd21a7a9a363****
Connection: close

<Delete>
    <Quiet>false</Quiet>
    <Object>
        <Key>example-object-2.jpg</Key>
        <VersionId>MTg0NDUxNzc2ODcwMjYyNjIwMTM</VersionId>
    </Object>
</Delete>

    响应

    HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 140
Connection: close
Date: Wed, 21 Aug 2019 11:24:44 GMT
Server: tencent-cos
x-cos-request-id: NWQ1ZDI5ZmJfNDhiNDBiMDlfMmIzODNfMTA0****

<DeleteResult>
    <Deleted>
        <Key>example-object-2.jpg</Key>
        <VersionId>MTg0NDUxNzc2ODcwMjYyNjIwMTM</VersionId>
    </Deleted>
</DeleteResult>

    案例五：删除指定删除标记

    请求

    POST /?delete HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Wed, 21 Aug 2019 12:04:04 GMT
Content-Type: application/xml
Content-Length: 154
Content-MD5: EKphCPpHcKiVqJtMqE+DmA==
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1566389044;1566396244&q-key-time=1566389044;1566396244&q-header-list=content-length;content-md5;content-type;date;host&q-url-param-list=delete&q-signature=f6b49a9b98386632b9545a4cc087449f789f****
Connection: close

<Delete>
    <Quiet>false</Quiet>
    <Object>
        <Key>example-object-1.jpg</Key>
        <VersionId>MTg0NDUxNzc2ODQ2NjU3ODM4NTc</VersionId>
    </Object>
</Delete>

    响应

    HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 253
Connection: close
Date: Wed, 21 Aug 2019 12:04:04 GMT
Server: tencent-cos
x-cos-request-id: NWQ1ZDMzMzRfYmIwMmEwOV83YTQzXzEyM2Ri****

<DeleteResult>
    <Deleted>
        <Key>example-object-1.jpg</Key>
        <DeleteMarker>true</DeleteMarker>
        <DeleteMarkerVersionId>MTg0NDUxNzc2ODQ2NjU3ODM4NTc</DeleteMarkerVersionId>
        <VersionId>MTg0NDUxNzc2ODQ2NjU3ODM4NTc</VersionId>
    </Deleted>
</DeleteResult>

    案例六：部分删除失败

    请求

    POST /?delete HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Wed, 21 Aug 2019 12:04:05 GMT
Content-Type: application/xml
Content-Length: 436
Content-MD5: ZAbgvje31aO+0j7pkEkYvQ==
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1566389045;1566396245&q-key-time=1566389045;1566396245&q-header-list=content-length;content-md5;content-type;date;host&q-url-param-list=delete&q-signature=543a9f9f65c45e533a415afe5d014cdc9c73****
Connection: close

<Delete>
    <Quiet>false</Quiet>
    <Object>
        <Key>example-object-1.jpg</Key>
    </Object>
    <Object>
        <Key>example-object-2.jpg</Key>
        <VersionId>MTg0NDUxNzc2ODQ2NjQ1MjM5MTk</VersionId>
    </Object>
    <Object>
        <Key>example-object-3.jpg</Key>
        <VersionId>MTg0NDUxNzc2ODQ2NjQwMTIwMDI</VersionId>
    </Object>
    <Object>
        <Key>example-object-4.jpg</Key>
        <VersionId>MTg0NDUxNzc2ODQ2NjQ0NjI0MDQ</VersionId>
    </Object>
</Delete>

    响应

    HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 703
Connection: close
Date: Wed, 21 Aug 2019 12:04:06 GMT
Server: tencent-cos
x-cos-request-id: NWQ1ZDMzMzVfOTNjMjJhMDlfMzhiM18xMWY3****

<DeleteResult>
    <Deleted>
        <Key>example-object-1.jpg</Key>
        <DeleteMarker>true</DeleteMarker>
        <DeleteMarkerVersionId>MTg0NDUxNzc2ODQ2NjM1NTI2NDY</DeleteMarkerVersionId>
    </Deleted>
    <Deleted>
        <Key>example-object-2.jpg</Key>
        <VersionId>MTg0NDUxNzc2ODQ2NjQ1MjM5MTk</VersionId>
    </Deleted>
    <Deleted>
        <Key>example-object-3.jpg</Key>
        <DeleteMarker>true</DeleteMarker>
        <DeleteMarkerVersionId>MTg0NDUxNzc2ODQ2NjQwMTIwMDI</DeleteMarkerVersionId>
        <VersionId>MTg0NDUxNzc2ODQ2NjQwMTIwMDI</VersionId>
    </Deleted>
    <Error>
        <Key>example-object-4.jpg</Key>
        <VersionId>MTg0NDUxNzc2ODQ2NjQ0NjI0MDQ</VersionId>
        <Code>PathConflict</Code>
        <Message>Path conflict.</Message>
    </Error>
</DeleteResult>

    目录