PUT Bucket Version

最近更新时间:2019-11-14 11:33:29

PUT Bucket Version


描述

此 PUT 操作使用 version 资源来设定用户空间的多版本设置。

若使用此接口需要用户是此空间的拥有者。

用户可以通过此接口开启或关闭多版本:

  • 开启状态:所有上传到存储空间下的文件都会标识一个唯一的版本ID

  • 关闭状态:所有上传到存储空间下的文件都会标识一个值为null的版本ID

请求

语法

PUT /?versioning HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <Status>string</Status>
</VersioningConfiguration>.

注意:

请求参数

该接口不使用请求参数。

请求头部

该接口只使用常用请求头部。获取更多信息,请点击常用请求头部

请求内容

名称 描述
Status 存储空间的多版本状态。
类型: String
有效值:Enabled Suspended

响应

响应头部

该接口可以使用所有常用响应头部。获取更多信息,请点击常用响应头部

响应内容

该接口不返回相应内容。

特殊错误

该接口不返回任何特殊错误。

示例

开启多版本请求示例

PUT /?versioning HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyun.com
Date: Fri, 26 Dec 2014 06:38:43 GMT
Authorization: authorization string
Content-Type: text/plain
Content-Length: 124

<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> 
  <Status>Enabled</Status> 
</VersioningConfiguration>

响应示例

HTTP/1.1 200 OK
Date: Fri, 26 Dec 2014 06:38:43 GMT
Server: Tengine

关闭多版本请求示例

PUT /?versioning HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyun.com
Date: Fri, 26 Dec 2014 06:38:43 GMT
Authorization: authorization string
Content-Type: text/plain
Content-Length: 124

<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> 
  <Status>Suspended</Status> 
</VersioningConfiguration>

关闭日志响应示例

HTTP/1.1 200 OK
Date: Fri, 26 Dec 2014 06:38:43 GMT
Server: Tengine

金山云,开启您的云计算之旅

注册有礼