DeleteObject
更新时间：2026-09-18
接口描述
此接口用于删除指定 Bucket 中的一个 Object，要求请求者对此 Object 有写权限。
如果指定 versionId，接口删除该版本对应的 Object；如果不指定 versionId，默认删除最新版本。
请求
请求结构
Http
1DELETE /{ObjectName} HTTP/1.1
2Host: {BucketName}.bj.bcebos.com
3Date: {Date}
4Authorization: {AuthorizationString}多版本请求结构如下：
Http
1DELETE /{ObjectName}?versionId={versionId} HTTP/1.1
2Host: {BucketName}.bj.bcebos.com
3Date: {Date}
4Authorization: {AuthorizationString}请求头域
无特殊 Header 参数。请求需包含以下标准或鉴权 Header。
| Header 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| Host | String | 是 | 请求的 BOS Endpoint，格式为 {BucketName}.bj.bcebos.com。 |
| Date | String | 是 | HTTP 请求时间，格式为 GMT。 |
| Authorization | String | 是 | BCE 鉴权签名字符串。 |
请求参数
| 字段 | 类型 | 位置 | 是否必需 | 描述 |
|---|---|---|---|---|
| ObjectName | String | Path | 是 | 目标 Object 的名称。 |
| versionId | String | Query | 否 | 目标版本的 ID。仅在启用版本控制功能时删除特定历史版本时指定，不指定默认删除最新版本。 |
该接口无 Body 参数。
响应
响应头域
成功响应无特殊业务 Header 返回。响应中可能包含以下通用 Header。
| Header 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| x-bce-request-id | String | 否 | 请求 ID，用于问题定位。 |
响应参数
无。成功删除 Object 后返回 204 No Content，响应 Body 为空。
注意事项
无。
示例
请求示例
Http
1DELETE /ObjectName HTTP/1.1
2Host: BucketName.bj.bcebos.com
3Date: Wed, 06 Apr 2016 06:34:40 GMT
4Authorization: AuthorizationString响应示例
Http
1HTTP/1.1 204 No Content
2x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
3Date: Wed, 06 Apr 2016 06:34:40 GMT
4Content-Length: 0
5Connection: close
6Server: BceBos多版本请求示例
Http
1DELETE /ObjectName?versionId=ADCQMlGFiNo%3D HTTP/1.1
2Host: BucketName.bj.bcebos.com
3Date: Wed, 06 Apr 2016 06:34:40 GMT
4Authorization: AuthorizationString多版本响应示例
Http
1HTTP/1.1 204 No Content
2x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
3Date: Wed, 06 Apr 2016 06:34:40 GMT
4Content-Length: 0
5Connection: close
6Server: BceBos评价此篇文章