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\"}"