帮你快速理解、总结文档立即下载
文档中心>对象存储>高性能存储>SDK 文档>Python SDK>对象操作>删除对象

删除对象

最近更新时间：2026-10-21 18:34:06
我的收藏

本页目录：

删除高性能桶中的单个对象（DELETE Object）。对高性能桶发起请求时，SDK 自动完成会话鉴权。

注意事项

对象键末尾的 / 严格区分文件对象与目录对象，不做容错。类型不匹配按对象不存在处理，返回 204 No Content，不会删除另一种类型的同名对象。
删除目录对象前先清空目录；非空目录返回 409 DirNotEmpty。
删除不存在的对象时，高性能桶按幂等语义处理，通常仍返回成功。
高性能桶不支持对象版本，传入 VersionId 会本地报错。
需要一次删除多个对象时，请使用 Python SDK 批量删除对象。
删除属于数据面接口，SDK 使用 session 临时凭证签名。

请求

方法原型

def delete_object(self, Bucket, Key, **kwargs)

参数说明

参数名称
参数描述
类型
是否必选
Bucket
高性能桶完整名称，格式为 <BucketName>-x--<APPID>
string
是
Key
对象键（Object Key），即对象在桶中的完整路径
string
是
kwargs
可选请求参数，使用本文列出的参数
dict
否

响应

返回值为响应头部字典：
参数名称
参数描述
类型
响应头 dict
成功时返回响应头部字典
dict

错误码

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

实际案例

# -*- coding=utf-8 -*-
import os
from qcloud_cos import CosConfig, CosS3Client

# 高性能桶经 VPC 内网 HTTP 80 端口接入，SDK 的网关 DNS 负载均衡也仅对 HTTP 请求生效；SDK 默认 https，此处需显式指定 http。
config = CosConfig(
    Scheme='http',
    Region='ap-guangzhou',
    SecretId=os.environ['COS_SECRET_ID'],
    SecretKey=os.environ['COS_SECRET_KEY'],
    Token=os.environ.get('COS_SECURITY_TOKEN'),
    EnableRapidDomain=True)
client = CosS3Client(config)

client.delete_object(Bucket='examplebucket-x--1250000000', Key='exampleobject.txt')
print('delete object OK')

中国站