版本控制故障排除

以下主题可以帮助您排查一些常见的 Amazon S3 版本控制问题。

我想恢复在启用版本控制的存储桶中意外删除的对象

通常，当从 S3 存储桶中删除对象版本时，Amazon S3 无法恢复它们。但是，如果您在 S3 存储桶上启用了 S3 版本控制，则未指定版本 ID 的 DELETE 请求无法永久删除对象。而是添加删除标记作为占位符。此删除标记将成为对象的当前版本。

要验证已删除的对象是永久删除还是临时删除（在其所在位置有删除标记），请执行以下操作：

您还可以使用 AWS Command Line Interface（AWS CLI）中的 HeadObject API 操作来验证已删除对象的状态。要执行此操作，请使用以下 head-object 命令并将 user input placeholders 替换为您自己的信息：

aws s3api head-object --bucket amzn-s3-demo-bucket --key index.html

如果您对受版本控制的对象运行 head-object 命令，而此对象的当前版本为删除标记，则会收到 404 找不到错误。例如：

调用 HeadObject 操作时发生错误（404）：找不到

如果您对受版本控制的对象运行 head-object 命令并提供该对象的版本 ID，Amazon S3 将检索该对象的元数据，确认该对象仍然存在而未被永久删除。

aws s3api head-object --bucket amzn-s3-demo-bucket --key index.html --version-id versionID

{
"AcceptRanges": "bytes",
"ContentType": "text/html",
"LastModified": "Thu, 16 Apr 2015 18:19:14 GMT",
"ContentLength": 77,
"VersionId": "Zg5HyL7m.eZU9iM7AVlJkrqAiE.0UG4q",
"ETag": "\"30a6ec7e1a9ad79c203d05a589c8b400\"",
"Metadata": {}
}

如果找到该对象并且最新版本是删除标记，则该对象的先前版本仍然存在。由于删除标记是对象的当前版本，因此您可以通过删除该删除标记来恢复对象。

永久移除删除标记后，该对象的第二个最新版本将成为该对象的当前版本，从而使您的对象再次可用。有关如何恢复对象的直观描述，请参阅移除删除标记。

要删除对象的特定版本，您必须是存储桶拥有者。要永久删除“删除标记”，必须在 DeleteObject 请求中包含其版本 ID。要删除该删除标记，请使用以下命令，然后将 user input placeholders 替换为您自己的信息：

aws s3api delete-object --bucket amzn-s3-demo-bucket --key index.html --version-id versionID

有关 delete-object 命令的更多信息，请参阅《AWS CLI 命令参考》中的 delete-object。有关永久删除相应删除标记的更多信息，请参阅管理删除标记。

我想永久删除受版本控制的对象

在已启用版本控制的存储桶中，没有版本 ID 的 DELETE 请求无法永久删除对象。相反，此类请求会插入一个删除标记。

要永久删除受版本控制的对象，可从以下方法中进行选择：

在启用版本控制的存储桶中，未指定版本 ID 的 DELETE 请求只能删除具有 NULL 版本 ID 的对象。如果对象是在启用版本控制后上传的，则未指定版本 ID 的 DELETE 请求会创建该对象的删除标记。

启用存储桶版本控制后，我遇到了性能下降问题

如果删除标记或受版本控制的对象过多，以及如果未遵循最佳实践，则启用版本控制的存储桶可能会出现性能降低问题。

删除标记过多

对存储桶启用版本控制后，针对对象发出的没有版本 ID 的 DELETE 请求将创建具有唯一版本 ID 的删除标记。具有将对象的当前版本设为过期规则的生命周期配置会向每个对象添加一个带有唯一版本 ID 的删除标记。过多的删除标记会降低存储桶的性能。

在对存储桶暂停版本控制时，Amazon S3 会对于新创建的对象将版本 ID 标记为 NULL。版本控制已暂停的存储桶中的过期操作会导致 Amazon S3 创建一个以 NULL 作为版本 ID 的删除标记。在版本控制已暂停的存储桶中，将为任何删除请求创建 NULL 删除标记。当删除所有对象版本而只保留单个删除标记时，这些 NULL 删除标记也称为过期对象删除标记。如果累积的 NULL 删除标记过多，则存储桶的性能会降低。

受版本控制的对象过多

如果启用了版本控制的存储桶包含具有数百万个版本的对象，则可能会出现 503 服务不可用错误。如果您注意到针对启用版本控制的存储存储桶的 PUT 或 DELETE 对象请求接收的 HTTP 503 服务不可用响应的数量显著增加，则存储桶中可能有一个或多个对象具有数百万个版本。如果您的对象有数以百万计的版本，Amazon S3 会自动限制对该存储桶的请求。限制请求数可以保护您的存储桶免受过多请求流量的影响，但也可能会妨碍对该存储桶发出的其他请求。

要确定哪些对象具有数以百万计的版本，请使用 S3 清单。S3 清单生成一份报告，用于提供存储桶中对象的平面文件列表。有关更多信息，请参阅 使用 S3 清单对数据进行编目和分析。

要验证存储桶中是否存在大量受版本控制的对象，请使用 S3 Storage Lens 存储统计管理工具指标来查看当前版本对象计数、非当前版本对象计数和删除标记对象计数。有关 Storage Lens 存储统计管理工具指标的更多信息，请参阅Amazon S3 Storage Lens 存储统计管理工具指标词汇表。

Amazon S3 团队鼓励客户调查重复覆盖同一对象的应用程序（可能会为该对象创建数百万个版本），以确定应用程序是否正常工作。例如，如果某个应用程序每分钟都要覆盖同一个对象，那么在一周时间内创建的版本数量会超过一万个。我们建议，为每个对象存储的版本数不超过十万个。如果您的应用场景需要一个或多个对象的数百万个版本，请联系 AWS 支持 团队以获得帮助，从而确定更好的解决方案。

最佳实践

为防止与版本控制相关的性能降级问题，建议您采用以下最佳实践：

有关其他 Amazon S3 性能优化最佳实践，请参阅最佳实践设计模式。