Amazon Simple Storage Service
开发人员指南 (API Version 2006-03-01)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

删除对象

您可以直接从 Amazon S3 删除一个或多个对象。删除对象时,您可以使用以下选项:

  • 删除单个对象 – Amazon S3 提供了删除 API,使您能够删除单个 HTTP 请求中的一个对象。

  • 删除多个对象 – Amazon S3 还提供了多对象删除 API,使您能够在单个 HTTP 请求中删除最多 1000 个对象。

从未受版本控制的存储桶删除对象时,您只需提供对象键名;从受版本控制的存储桶删除对象时,您可以选择提供对象的版本 ID 以删除特定版本的对象。

从受版本控制的存储桶中删除对象

如果您的存储桶受版本控制,则存储桶中可能存在同一对象的多个版本。使用受版本控制的存储桶时,删除 API 将提供以下选项:

  • 指定不受版本控制的删除请求 – 即您仅指定对象的键而不是版本 ID。在此情况下,Amazon S3 将创建一个删除标记并在响应中返回版本 ID。这将使您的对象从存储桶中消失。有关对象版本控制和删除标记概念的信息,请参阅 对象版本控制

  • 指定受版本控制的删除请求 – 即不仅可以指定键,还可以指定版本 ID。在此情况下,可能会出现以下两种结果:

    • 如果版本 ID 映射到特定的对象版本,则 Amazon S3 将删除该特定版本的对象。

    • 如果版本 ID 映射到对象的删除标记,则 Amazon S3 将删除该删除标记。这将使您的对象重新出现在存储桶中。

从启用了 MFA 的存储桶中删除对象

从启用了多重身份认证 (MFA) 的存储桶中删除对象时,请注意以下内容:

  • 如果您提供了无效的 MFA 令牌,请求将始终失败。

  • 如果您拥有一个启用了 MFA 的存储桶并且发送了一个受版本控制的删除请求 (您提供了对象键和版本 ID),若您不能提供有效的 MFA 令牌,请求将失败。此外,对启用了 MFA 的存储桶使用多对象删除 API 时,如果任意的删除是受版本控制的删除请求 (即您指定了对象键和版本 ID),若您不能提供有效的 MFA 令牌,则整个请求将失败。

另一方面,在下面的案例中请求将成功:

  • 如果您拥有一个启用了 MFA 的存储桶并且发送了一个不受版本控制的删除请求 (您不打算删除受版本控制的对象), 即使您不提供 MFA 令牌,删除也会成功。

  • 如果您拥有一个多对象删除请求并且仅指定了要从启用了 MFA 的存储桶删除的不受版本控制的对象, 即使您不提供 MFA 令牌,删除也会成功。

有关 MFA 删除的信息,请参阅 MFA 删除

相关资源