DeleteObject
删除文件(object)
服务地址:
华东1 金融云
输入参数
只看必填
bucketBucket信息
keyObject的完整路径
versionIdObject对应的版本ID
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

注意事项

  • 要删除文件,您必须有 Object 的写权限。
  • 无论要删除的 Object 是否存在,删除成功后均会返回 204 状态码。
  • 如果 Object 类型为软链接,使用 DeleteObject 接口只会删除该软链接。

版本控制

版本控制状态下的删除行为说明如下:

  • 未指定 versionId(临时删除): 如果在未指定 versionId 的情况下执行删除操作时,默认不会删除 Object 的当前版本,而是对当前版本插入删除标记(Delete Marker)。此时,在未指定 versionId 的情况下执行 GetObject 操作,OSS 会检测到当前版本为删除标记,并返回404 Not Found。此外,响应中还会返回 header:x-oss-delete-marker = true以及新生成的删除标记的版本号x-oss-version-idx-oss-delete-marker的值为 true,表示与返回的x-oss-version-id对应的版本为删除标记。

  • 指定 versionId(永久删除): 如果在指定 versionId 的情况下执行删除操作时,OSS 会根据params中指定的versionId参数永久删除该版本。如果要删除 ID 为“null”的版本,请在params参数中添加params['versionId'] = “null”,OSS 将“null”字符串当成“null”的 versionId,从而删除 versionId 为“null”的 Object。

请求语法

DELETE /{key} HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com

路径参数

字段名称字段详情
keystring

Object 的完整路径。

示例值:exampledir/exampleobject/txt

请求参数

字段名称字段详情
bucketstring

Bucket 信息。

示例值:examplebucket
versionIdstring

Object 对应的版本 ID。

示例值:CAEQMxiBgIDh3ZCB0BYiIGE4YjIyMjExZDhhYjQxNzZiNGUyZTI4ZjljZDcz****

返回参数

变更历史
暂无变更历史