bucket-versioning命令用于设置或查询存储空间（Bucket）的版本控制配置。

说明
  • 本文命令均以Linux系统为例，实际使用时，请将命令名称改为您实际可执行程序文件的名称。例如Windows 32位系统的帮助命令为ossutil32.exe help。
  • Bucket版本控制功能详情请参见版本控制介绍。

命令格式

  • 开启/暂停版本控制 
    ./ossutil bucket-versioning --method put oss://bucket versioning_parameter
    --method选项为put时，versioning状态参数只能为enabled或suspended。
    • 当versioning状态参数为enabled时，表示开启版本控制功能。
    • 当versioning状态参数为suspended时，表示暂停版本控制功能。
  • 查询版本控制配置 
    ./ossutil bucket-versioning --method get oss://bucket

使用示例

  • 开启Bucket版本控制 
    ./ossutil bucket-versioning --method put oss://bucket1 enabled
  • 暂停Bucket版本控制 
    ./ossutil bucket-versioning --method put oss://bucket1 suspended
  • 查询Bucket版本控制配置 
    ./ossutil bucket-versioning --method get oss://bucket1
bucket versioning status:Suspended
    说明 Bucket版本控制有如下三个状态：
    • Enabled：表示该Bucket已开启版本控制。此状态下，删除或覆写Object都会生成对应的Object版本。详情请参见开启版本控制。
    • Suspended：表示该Bucket已暂停版本控制。此状态下，您仍旧可以通过指定versionId对历史版本Object进行下载、拷贝、删除等操作。若对Object进行覆写或删除操作时，会生成一个versionid为null的版本，此versionid唯一。若Object的当前版本已经是null，则覆写或删除操作会新生成一个null版本覆盖当前版本。详情请参见暂停版本控制。
    • Null：表示没有开启过版本控制功能。若Bucket曾经开启过版本控制功能，将无法再变为Null状态。

常用选项

您可以在使用bucket-versioning命令时附加如下选项：
选项名称 描述
--method 表示http的请求类型。取值：
  • put：开启或暂停版本控制功能。
  • get：获取配置。
--loglevel 设置日志级别，默认为空，表示不输出日志文件。可选值为：
  • info：输出提示信息日志。
  • debug：输出详细信息日志（包括http请求和响应信息）。
--proxy-host 网络代理服务器的url地址，支持http、https、socks5。例如http://120.79.**.**:3128、 socks5://120.79.**.**:1080。
--proxy-user 网络代理服务器的用户名，默认为空。
--proxy-pwd 网络代理服务器的密码，默认为空。
说明 更多通用选项请参见查看选项。