You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

请输入
  • 文档首页
    • 对象存储API 参考存储桶版本控制PutBucketVersioning
复制全文
下载 pdf
我的收藏
版本控制
PutBucketVersioning
复制全文
下载 pdf
我的收藏
PutBucketVersioning
功能描述​
此接口用于为存储桶设置版本控制功能。版本控制功能可以为存储桶内的同一个对象同时保留多个版本，防止意外删除或覆盖对象，也可以用于归档历史版本对象。​
注意事项​
  • 只有拥有 PutBucketVersioning 权限的用户才能调用 PutBucketVersioning接口。默认情况下，存储桶的所有者直接拥有 PutBucketVersioning 权限，存储桶所有者也可以将该权限授予给其他用户。使用桶策略实现权限控制的详细说明，请参见存储桶授权策略管理。​
  • 存储桶的版本控制功能默认不开启。关于存储桶版本控制功能的详细说明，请参见版本控制概述。​
  • 分层桶不支持 PutBucketVersioning 接口。​
请求消息样式​
​
PUT /?versioning HTTP/1.1 ​
Host: bucketname.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string​
​
{ ​
"Status":"Enabled"​
}​
​
请求参数和消息头​
该请求使用的公共请求消息头，请参见公共参数。​
​
名称​
位置​
参数类型​
是否必选​
示例值​
说明​
versioning​
Query​
String​
是​
-​
代表 PutBucketVersioning 请求的特殊标识。​
​
请求元素​
​
名称​
参数类型​
是否必选​
示例值​
说明​
Status​
String​
是​
Enabled​
是否开启存储桶的版本控制功能，取值如下：​
  • Enabled：开启版本控制功能。​
  • Suspended：暂停版本控制功能。​
​
响应消息头​
该请求返回的公共响应消息头，请参见公共参数。​
响应元素​
该请求响应中无消息元素。​
请求示例​
​
PUT /?versioning HTTP/1.1 ​
Host: bucketname.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string​
​
{ ​
"Status":"Enabled"​
}​
​
响应示例​
​
HTTP/1.1 200 OK​
x-tos-id-2: 1874010a59fb053f650a59fb-be4a38d-1qin1v-PuO-cb-tos-front-azc-1 ​
x-tos-request-id: 1874010a59fb053f650a59fb-be4a38d-1qin1v-PuO-cb-tos-front-azc-1 ​
Date: Wed, 20 Sep 2023 02:28:54 GMT​
server: TosServer​
Content-Length: 0​
​
​
最近更新时间：2025.09.05 15:47:27
这个页面对您有帮助吗？
有用
有用
无用
无用