put-bucket-versioning

put-bucket-versioning命令用于设置指定存储空间(Bucket)的版本控制状态。

注意事项

  • 要配置版本控制,您必须有PutBucketVersioning权限。

  • Bucket包括未开启、开启(Enabled)或者暂停(Suspended)三种版本控制状态。默认情况下Bucket处于未开启版本控制状态。

  • 在Bucket处于开启版本控制状态下,所有新添加的文件(Object)都将拥有唯一的版本ID,OSS将累积所添加Object的多个版本。

  • 在Bucket处于暂停版本控制状态下,所有新添加Object的版本ID将为null,且OSS将不再为此状态下添加的Object累积更多的版本。

关于版本控制的更多信息,请参见版本控制概述

命令格式

ossutil api put-bucket-versioning --bucket value --versioning-configuration value [flags]

参数

类型

说明

--bucket

string

Bucket名称。

--versioning-configuration

string

版本控制配置的容器。

说明

put-bucket-versioning命令对应API接口PutBucketVersioning。关于API中的具体参数含义,请参见PutBucketVersioning

--versioning-configuration

--versioning-configuration配置选项既支持XML语法也支持JSON语法:

  • XML语法:

    <VersioningConfiguration>
      <Status>string</Status>
    </VersioningConfiguration>
  • JSON语法:

    {
      "Status": "string"
    }
说明

关于支持的全局命令行选项,请参见支持的全局命令行选项

使用示例

设置存储空间examplebucket的版本控制状态。

  • 使用XML配置文件,versioning-configuration.xml内容如下:

    <?xml version="1.0" encoding="UTF-8"?>
    <VersioningConfiguration>
            <Status>Enabled</Status>
    </VersioningConfiguration>

    命令示例如下:

    ossutil api put-bucket-versioning --bucket examplebucket --versioning-configuration file://versioning-configuration.xml
  • 使用JSON配置文件,versioning-configuration.json内容如下:

    {
            "Status": "Enabled"
    }

    命令示例如下:

    ossutil api put-bucket-versioning --bucket examplebucket --versioning-configuration file://versioning-configuration.json
  • 使用JSON配置参数,命令示例如下:

    ossutil api put-bucket-versioning --bucket examplebucket --versioning-configuration "{\"Status\":\"Enabled\"}"