You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

PutBucketVersioning

最近更新时间：2023.11.21 10:22:22

首次发布时间：2023.10.12 19:40:16

我的收藏

功能描述

此接口用于为存储桶设置版本控制功能。版本控制功能可以为存储桶内的同一个对象同时保留多个版本，防止意外删除或覆盖对象，也可以用于归档历史版本对象。

注意事项

  • 只有拥有 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

是否开启存储桶的版本控制功能，取值如下：

  • Enable：开启版本控制功能。
  • 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