PutBucketVersioning--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

PutBucketVersioning

最近更新时间：2024.08.01 20:30:31首次发布时间：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	是否开启存储桶的版本控制功能，取值如下： `Enabled`：开启版本控制功能。 `Suspended`：暂停版本控制功能。

名称

参数类型

是否必选

示例值

说明

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