PutBucketVersioning
所有文档
menu

对象存储 BOS

PutBucketVersioning

产品详情自助选购

接口描述

调用PutBucketVersioning设置指定存储空间(Bucket)的版本控制状态。

注意事项

  • 要配置版本控制,您必须有PutBucketVersioning权限。
  • Bucket包括未开启(notEnabled)、开启(enabled)或者暂停(suspended)三种版本控制状态。默认情况下Bucket处于未开启版本控制状态。
  • 在Bucket处于开启版本控制状态下,所有新添加的文件(Object)都将拥有唯一的版本ID,将累积所添加Object的多个版本。
  • 在Bucket处于暂停版本控制状态下,所有新添加Object的版本ID将为null,将不再为此状态下添加的Object累积更多的版本。

请求(Request)

  • 请求语法

PUT /?versioning HTTP/1.1
Host: <BucketName>.bj.bcebos.com
x-bce-date: <Date>
Content-Length: <ContentLength>
Content-Type:application/json; charset=utf-8
Authorization: <AuthorizationString>
{status:enabled}

响应(Response)

  • 响应头域无特殊Header参数返回
  • 响应元素无

示例

  • 设置多版本状态的示例

    PUT /?versionging HTTP/1.1
    Host: BucketName.bj.bcebos.com
    x-bce-date: 2024-04-06T08:23:49Z 
    Content-Length : 16
    Content-Type: application/json; charset=utf-8
    Authorization: AuthorizationString
    {status:enabled}
  • 响应示例

    HTTPS/1.1 200 OK
    x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
    Content-Length: 0
    Date: Wed, 06 Apr 2024 06:34:40 GMT
    Server: BceBos
上一篇
标签管理
下一篇
GetBucketVersioning