全部產品
Search
文件中心

Object Storage Service:put-bucket-versioning

更新時間:Aug 01, 2024

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