tencent cloud

Overview

This document provides an overview of APIs and SDK code samples related to versioning.

Setting versioning

Feature description

This API is used to enable or suspend versioning for a bucket.

1. If you have never enabled versioning for the bucket, GET Bucket versioning will not return a versioning status.
2. Once enabled, versioning can only be suspended but cannot be disabled.
3. Set the versioning status value to Enabled or Suspended to enable or suspend versioning, respectively.
4. To set versioning for a bucket, you need to have write permission for the bucket.

Sample request

cos.putBucketVersioning({
    Bucket: 'examplebucket-1250000000', /*Required*/
    Region: 'COS_REGION',     /* Bucket region. Required */
    VersioningConfiguration: {
        Status: "Enabled"
    }
}, function (err, data) {
    console.log(err || data);
});

Parameter description

Callback function description

function(err, data) { ... }

Querying versioning

Feature description

This API is used to query the versioning configuration of a bucket.

Sample request

cos.getBucketVersioning({
    Bucket: 'examplebucket-1250000000', /*Required*/
    Region: 'COS_REGION',     /* Bucket region. Required */
}, function (err, data) {
    console.log(err || data);
});

Parameter description

Callback function description

function(err, data) { ... }