View a markdown version of this page

将对象添加到已启用版本控制的存储桶 - Amazon Simple Storage Service

将对象添加到已启用版本控制的存储桶

您在存储桶上启用了版本控制后，Amazon S3 会自动将唯一的版本 ID 添加到存储在该存储桶中的每个对象（使用 PUT、POST 或 CopyObject）。

下图显示当将对象添加到已启用版本控制的存储桶时，Amazon S3 会向其添加唯一的版本 ID。

在启用了版本控制的存储桶中放置对象时，为该对象添加了唯一版本 ID。
注意

Amazon S3 分配的版本 ID 值是 URL 安全的（可以包含在 URI 中）。

有关版本控制的更多信息，请参阅使用 S3 版本控制保留对象的多个版本。您可以使用控制台、AWS SDK 和 REST API 将对象版本添加到启用版本控制的存储桶中。

有关说明，请参阅上传对象。

有关使用适用于 Java、.NET 和 PHP 的 AWS SDK 上传对象的示例，请参阅 上传对象。在无版本控制和启用版本控制的存储桶中上传对象的示例是相同的，只是对于启用版本控制的存储桶，Amazon S3 会分配版本号。否则，版本号为空。

有关使用其他 AWS SDK 的信息，请参阅 AWS 开发人员中心。

要将对象添加到已启用版本控制的存储桶

  1. 使用 PutBucketVersioning 请求在存储桶上启用版本控制。

    有关更多信息，请参阅《Amazon Simple Storage Service API 参考》中的 PutBucketVersioning。

  2. 发送 PUT、POST 或 CopyObject 请求，以在存储桶中存储对象。

当您将对象添加到已启用版本控制的存储桶时，Amazon S3 将在 x-amz-version-id 响应标头中返回该对象的版本 ID，如下面的示例所示。

x-amz-version-id: 3/L4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY