The GET Bucket versioning API is used to get the versioning information of a bucket.
If you have never enabled or suspended versioning for the bucket, the response is:
<VersioningConfiguration/>
If you have enabled versioning for the bucket, the response is:
<VersioningConfiguration>
<Status>Enabled</Status>
</VersioningConfiguration>
If you have suspended versioning for the bucket, the response is:
<VersioningConfiguration>
<Status>Suspended</Status>
</VersioningConfiguration>
GET /?versioning HTTP 1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT date
Authorization: Auth String
Authorization: Auth String (see Request Signature for details).
This API only uses common request headers. For more information on common request headers, see Common Request Headers.
The request body of this request is empty.
This API only uses common response headers. For more information on common request headers, see Common Response Headers.
<VersioningConfiguration>
<Status></Status>
</VersioningConfiguration>
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 |
This API uses standardized error responses and error codes. For more information, see Error Codes .
GET /?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
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=5118a936049f9d44482bbb61309235cf4abe****
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 120
Connection: keep-alive
Date: Wed, 23 Aug 2017 08:15:16 GMT
Server: tencent-cos
x-cos-request-id: NTk5ZDM5OTRfZDNhZDM1MGFfMjYyMTFfZmU3****
<?xml version='1.0' encoding='utf-8' ?>
<VersioningConfiguration>
<Status>Enabled</Status>
</VersioningConfiguration>
Was this page helpful?