DeleteObject
删除文件(object)
服务地址:
华东1 金融云
参数配置
高级配置
输入参数
只看必填
注意事项
bucketBucket信息
keyObject的完整路径
versionIdObject对应的版本ID
文档
调用结果
SDK 示例
CLI示例
相关示例
调用历史
错误码
流控
插件下载了解更多
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
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-id
。x-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**** |
返回参数
变更历史
暂无变更历史