Put Bucket Versioning
功能描述
Put Bucket Versioning實現(xiàn)啟用或者暫停版本控制功能。
該PUT操作的這種實現(xiàn)使用 versioning子資源來設(shè)置現(xiàn)有存儲桶的版本控制狀態(tài)。要設(shè)置版本控制狀態(tài)罐旗，您必須是存儲桶所有者露戒。
您可以使用以下值之一設(shè)置版本控制狀態(tài)：
1.Enabled-
啟用版本在桶中的對象
添加到存儲桶的所有對象都會收到唯一的版本ID盈魁。
2.Suspended -
禁用存儲桶中對象的版本控制
添加到存儲桶的所有對象都會收到版本號null乡范。
重要
如果您的非版本桶中有對象到期生命周期策略裁眯，并且您希望在啟用版本控制時保持相同的永久刪除行為偎捎，則必須添加非當(dāng)前過期策略蠢终。
非當(dāng)前過期生命周期策略將管理啟用版本的桶中的非當(dāng)前對象版本的刪除。
了解生命周期詳細(xì)請參見 生命周期 章節(jié)茴她。
請求
語法示例：
PUT /?versioning HTTP 1.1
Host:<Bucketname>-<APPID>.<Region>.myqcloud.com
Date:date
Authorization: Auth
Authorization: Auth String (詳細(xì)參見 請求簽名 章節(jié))
請求行
PUT /destinationObject HTTP 1.1
該 API 接口接受 PUT請求寻拂。
請求頭
公共頭部
該請求操作的實現(xiàn)使用公共請求頭,了解公共請求頭詳細(xì)請參見 公共請求頭部 章節(jié)。
非公共頭部
該請求操作無特殊的請求頭部信息丈牢。
請求體
<VersioningConfiguration>
<Status>Enabled</Status>
</VersioningConfiguration>
具體的數(shù)據(jù)內(nèi)容如下：
| 節(jié)點名稱（關(guān)鍵字） | 父節(jié)點 | 描述 | 類型 |
|---|---|---|---|
| VersioningConfiguration | 無 | 說明版本控制的具體信息 | Container |
| Status | VersioningConfiguration | 說明版本是否開啟兜喻，枚舉值：Suspended|Enabled | Enum |
響應(yīng)
響應(yīng)頭
公共響應(yīng)頭
該響應(yīng)使用公共響應(yīng)頭,了解公共響應(yīng)頭詳細(xì)請參見 公共響應(yīng)頭部 章節(jié)。
特有響應(yīng)頭
該響應(yīng)無特殊的響應(yīng)頭赡麦。
響應(yīng)體
該響應(yīng)體返回為空朴皆。
實際案例
PUT /?versioning HTTP/1.1
Host: testbucket-1322448703.cn-north.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=AKID15IsskiBQKTZbAo6WhgcBqVls9SmuG00&q-sign-time=1480932292;1981012292&q-key-time=1480932292;1981012292&q-url-param-list=versioning&q-header-list=host&q-signature=47ec2b80c73788ecd394d3b9ad90e120a32f9779
Content-Length: 83
<VersioningConfiguration>
<Status>Enabled</Status>
</VersioningConfiguration>
響應(yīng)
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: NTk5ZDM5N2RfMjNiMjM1MGFfMmRiX2Y0ZThm
