赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. 常用工具
  6. 命令行工具ossutil 2.0
  7. ossutil命令
  8. API级命令
  9. 关于Bucket操作
  10. 版本控制(Versioning)
  11. put-bucket-versioning

put-bucket-versioning

  • 版本控制(Versioning)
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

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\"}"
相关文章

put-bucket-versioning 2025-04-21 17:28

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

get-bucket-versioning 2025-04-21 17:28

get-bucket-versioning命令用于获取指定Bucket的版本控制状态。 注意事项 要获取指定Bucket的版本控制状态,您必须有oss:GetBucketVersioning

list-object-versions 2025-04-21 17:28

list-object-versions命令用于列出Bucket中包括删除标记(Delete Marker)在内的所有Object的版本信息。 注意事项 要列出Object的版本信息,您必须有os

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号