Amazon Simple Storage Service
API Reference (API Version 2006-03-01)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

Versioning

By default, x-amz-copy-source identifies the latest version of an object to copy. (If the latest version is a Delete Marker, Amazon S3 behaves as if the object was deleted.) To copy a different version, use the versionId subresource.

If you enable Versioning on the target bucket, Amazon S3 generates a unique version ID for the object being copied. This version ID is different from the version ID of the source object. Amazon S3 returns the version ID of the copied object in the x-amz-version-id response header in the response.

If you do not enable versioning or suspend it on the target bucket, the version ID Amazon S3 generates is always null.

To see sample requests that use versioning, see Sample Request: Copying a specified version of an object.