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\"}"
文档内容是否对您有帮助?