删除对象

最近更新时间:2025-08-01 18:08:22

我的收藏

简介

腾讯云对象存储(Cloud Object Storage,COS)支持对上传到存储桶中的单个或多个对象进行删除。您可以通过控制台、 API、SDK 等多种方式批量删除对象。默认情况下,当删除任务都成功完成时,返回的内容通常为空。若有发生错误,则会返回错误信息。
说明:
单次请求最多可删除1000个对象,若需要删除更多对象,请将列表拆分后分别发送请求。
如果您选择删除“文件夹”,则会同时删除“文件夹”下所有对象,在未开启版本控制的情况下,删除数据将不可恢复和访问。
如果您当前的存储桶已开启版本控制(包括启用和暂停状态),执行删除操作并不会真实将对象删除,而是会给当前版本对象打上删除标记,同时您的存储量不会减少。如需真实删除对象,则需要指定版本 ID,更多介绍请参见 版本控制概述
如果需要删除大量数据或者嵌套文件夹,您需要耗费较长时间才能完成删除,建议该类场景 设置生命周期 进行删除。

适用场景

腾讯云对象存储(Cloud Object Storage,COS)支持直接删除一个或多个对象,当仅需要删除一个对象时,您只需要提供对象键,就可以调用一个 API 请求来删除它。

使用方法

使用对象存储控制台

在未开启版本控制的存储桶中删除对象

2. 在左侧导航栏中,单击存储桶列表,进入存储桶列表页面。
3. 找到对象所在的存储桶,单击其存储桶名称,进入存储桶管理页面。
4. 在左侧导航栏中,选择文件列表,进入文件列表页面。
5. 选择想要删除的单个或多个对象,单击上方的更多操作 > 删除
6. 在弹出的提示窗口中,单击删除即可删除对象。

在开启/暂停版本控制的存储桶中删除对象

说明:
如果存储桶曾经使用过版本控制功能,那么在删除对象时需要指定版本 ID 才能真实删除对象。如果不指定版本 ID 删除对象,则不会真实删除对象,而是给当前版本的对象添加一个删除标记,更多介绍请参见 版本控制概述
2. 在左侧导航栏中,单击存储桶列表,进入存储桶列表页面。
3. 找到对象所在的存储桶,单击其存储桶名称,进入存储桶管理页面。
4. 在左侧导航栏中,选择文件列表,进入文件列表页面。
5. 在上方打开“列出历史版本”选项,然后勾选需要删除的单个或多个对象版本,单击上方的更多操作 > 删除
6. 在弹出的提示窗口中,单击删除即可真实删除对象。

使用 REST API

您可以直接使用 REST API 发起删除单个或多个对象请求,请参见 DELETE ObjectDELETE Multiple Objects API 文档。

使用 SDK

您可以直接调用 SDK 的删除单个对象方法,详情请参见下列各语言 SDK 文档: