PutBucketVersioning
更新时间 2026-04-10 20:09:10
最近更新时间: 2026-04-10 20:09:10
功能说明
PutBucketVersioning设置桶多版本请求可以将某个桶设置为多版本,这样用户每一次上传到该桶的同名对象都会作为历史对象保留,不会覆盖;开启之后无法关闭,只能暂停,暂停之后上传到该桶的新对象不再是多版本。
请求消息样式
PUT /{Bucket}?versioning HTTP/1.1
Host: xxx.zos.ctyun.cn
Accept-Encoding: identity
X-Amz-Date: 20220407T135856Z
X-Amz-Content-SHA256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Authorization: string
Content-Length: 124
<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Status>Enabled</Status>
</VersioningConfiguration>请求消息参数
| 参数名称 | 描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释: 桶的名称。 | String | 是 |
请求消息头
该请求使用公共的请求消息头,请参见如何调用API-构造请求-请求消息头。
请求消息元素
| 名称 | 描述 | 类型 | 是否必须 |
|---|---|---|---|
| VersioningConfiguration | 参数解释: 桶的多版本配置信息。 | Container | 是 |
| Status | 参数解释: 桶的版本控制状态信息。 取值范围: - Enabled:开启 - Suspended:暂停 | String | 是 |
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: tx000000000000000000003-00624cf54a-455da-default
Content-Type: application/xml
Content-Length: 0
Date: Wed, 06 Apr 2022 02:04:58 GMT
Connection: Keep-Alive响应消息头
该请求的响应消息使用公共的响应消息头,请参见如何调用API-响应结果-响应消息头。
响应消息元素
该请求的响应中不带有响应元素。
错误码
请参见调用前必知-错误码-全局错误码。