PUT Bucket versioning

Last updated: 2020-06-30 17:44:53


    The PUT Bucket versioning 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 state value.
    2. Once enabled, versioning can only be suspended but cannot be disabled.
    3. Set the versioning state value to Enabled or Suspended to enable or suspend versioning, respectively.
    4. To set versioning for a bucket, you need to have the permission to write to the bucket.


    Sample Request

    PUT /?versioning HTTP 1.1
    Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
    Date: GMT date
    Authorization: Auth String

    Authorization: Auth String (see Request Signature for more information).

    Request Headers

    This API only uses common request headers. For more information on common request headers, see Common Request Headers.

    Request Body


    Please find the details below:

    Node Name (Keyword) Parent Node Description Type
    VersioningConfiguration None Describes the detailed information on versioning Container
    Status VersioningConfiguration Indicates whether versioning is enabled; enumerators: Suspended, Enabled Enum


    Response Headers

    This API only uses common response headers. For more information on common request headers, see Common Response Headers.

    Response Body

    This response body is empty.

    Error Codes

    This API uses standardized error responses and error codes. For more information, see Error Codes .



    PUT /?versioning HTTP/1.1
    Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
    Connection: keep-alive
    Accept-Encoding: gzip, deflate
    Accept: */*
    User-Agent: python-requests/2.12.4
    Content-Type: application/xml
    Authorization: q-sign-algorithm=sha1&q-ak=AKID15IsskiBQKTZbAo6WhgcBqVls9Sm****&q-sign-time=1480932292;1981012292&q-key-time=1480932292;1981012292&q-url-param-list=versioning&q-header-list=host&q-signature=47ec2b80c73788ecd394d3b9ad90e120a32f****
    Content-Length: 83


    HTTP/1.1 200 OK
    Content-Type: application/xml
    Content-Length: 0
    Connection: keep-alive
    Date: Wed, 23 Aug 2017 08:14:53 GMT
    Server: tencent-cos
    x-cos-request-id: NTk5ZDM5N2RfMjNiMjM1MGFfMmRiX2Y0****