| « PreviousNext » | |
   | Did this page help you? Yes | No | Tell us about it... |
Suspending Versioning
The bucket owner can suspend versioning to stop accruing object versions. When you suspend versioning, the objects in your bucket do not change, as shown in the following figure.
What changes is how Amazon S3 handles objects in future requests. For a more detailed explanation of the effects of suspending versioning, see Working with Versioning-Suspended Buckets.
To suspend object versioning
In the header of a
PUT Bucketrequest, include theversioningsub-resource.In the body of the request, use
Suspendedfor the value of theStatusrequest element.
Example Suspending Versioning
The following request suspends versioning on bucketName.
PUT /?versioning HTTP/1.1
Host: bucketName.s3.amazonaws.com
Date: Wed, 12 Oct 2009 17:50:00 GMT
Authorization: AWS AKIAIOSFODNN7EXAMPLE:xQE0diMbLRepdf3YB+FIEXAMPLE=
Content-Type: text/plain
Content-Length: 124
<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Status>Suspended</Status>
</VersioningConfiguration>If you configured a bucket to be MFA Delete enabled, you must include the
x-amz-mfa request header and the MfaDelete request element in the request to change the bucket's
versioning state.
Example Suspending Versioning Using MFA Delete
The following request suspends versioning on bucketName
that is configured with MFA Delete.
PUT /?versioning HTTPS/1.1
Host: bucketName.s3.amazonaws.com
Date: Wed, 12 Oct 2009 17:50:00 GMT
Authorization: AWS AKIAIOSFODNN7EXAMPLE:xQE0diMbLRepdf3YB+FIEXAMPLE=
x-amz-mfa: 20899872 301749
Content-Type: text/plain
Content-Length: 124
<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Status>Suspended</Status>
<MfaDelete>Enabled</MfaDelete>
</VersioningConfiguration>Note that requests that include x-amz-mfa must use
HTTPS.
