DeleteObject_对象存储_API文档

插件下载了解更多
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。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
oss:DeleteObject
Delete
Object
acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}/{#ObjectName}
acs:UserAgent
acs:AccessId
oss:BucketTag
oss:DataAccessPointAccount
oss:AccessPointNetworkOrigin
oss:DataAccessPointArn
oss:TLSVersion
oss:DeleteObjectVersion
oss:GetObject

请求语法

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

路径参数

字段名称字段详情
keystring

Object 的完整路径。

示例值:exampledir/exampleobject/txt

请求参数

字段名称字段详情
bucketstring

Bucket 信息。

示例值:examplebucket
versionIdstring

Object 对应的版本 ID。

示例值:CAEQMxiBgIDh3ZCB0BYiIGE4YjIyMjExZDhhYjQxNzZiNGUyZTI4ZjljZDcz****

变更历史

暂无变更历史

相关示例