Object Storage Service:PutBucketVersioning

Usage notes

• Before you configure the versioning state for a bucket, you must have the PutBucketVersioning permission.

• A bucket can be in one of the following versioning states: disabled, enabled, or suspended. By default, versioning is disabled for a bucket.

• If versioning is enabled for a bucket, OSS generates unique version IDs for all objects that are added to the bucket. In this case, OSS stores multiple versions of the objects.

• If versioning is suspended for a bucket, OSS generates the version ID null for all objects that are added to the bucket. In this case, OSS does not store new versions for objects that are deleted or overwritten.

For more information about versioning, see Versioning.

Request syntax

PUT /?versioning HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<VersioningConfiguration>
    <Status>Enabled</Status>
</VersioningConfiguration>

Request headers

All headers in a DescribeRegions request are common request headers. For more information, see Common request headers.

Request parameters

Response headers

All headers in the response to a DescribeRegions request are common response headers. For more information, see Common response headers.

Examples

• Sample requests for enabling versioning for a bucket

  PUT /?versioning HTTP/1.1
  Host: bucket-versioning.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 02:20:12 GMT
  Authorization: OSS qn6q**************:77Dv****************
  <?xml version="1.0" encoding="UTF-8"?>
  <VersioningConfiguration>
      <Status>Enabled</Status>
  </VersioningConfiguration>

  Sample responses

  HTTP/1.1 200 OK
  x-oss-request-id: 5CAC015CB7AEADE01700****
  Date: Tue, 09 Apr 2019 02:20:12 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

• Sample requests for suspending versioning for a bucket

  PUT /?versioning HTTP/1.1
  Host: bucket-versioning.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 02:28:18 GMT
  Authorization: OSS qn6q**************:77Dv****************
  <?xml version="1.0" encoding="UTF-8"?>
  <VersioningConfiguration>
      <Status>Suspended</Status>
  </VersioningConfiguration>

  Sample responses

  HTTP/1.1 200 OK
  x-oss-request-id: 5CAC0342B7AEADE01700****
  Date: Tue, 09 Apr 2019 02:28:18 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

OSS SDKs

You can use OSS SDKs for the following programming languages to call the PutBucketVersioning operation:

• Java

• Python

• Go V2

• C++

• .NET

• Node.js

ossutil

For information about the ossutil command that corresponds to the PutBucketVersioning operation, see put-bucket-versioning.

Error codes