更新时间:2024-04-26 GMT+08:00

设置桶多版本状态

开发过程中,您有任何问题可以在github上提交issue接口参考文档详细介绍了每个接口的参数和使用方法。

您可以通过ObsClient.setBucketVersioning设置桶的多版本状态。OBS中的桶支持两种多版本状态:

多版本状态

说明

OBS服务端对应值

启用状态

  1. 上传对象时,系统为每一个对象创建一个唯一版本号,上传同名的对象将不再覆盖旧的对象,而是创建新的不同版本号的同名对象。
  2. 可以指定版本号下载对象,不指定版本号默认下载最新对象。
  3. 删除对象时可以指定版本号删除,不带版本号删除对象仅产生一个带唯一版本号的删除标记,并不删除对象。
  4. 列出桶内对象列表(ObsClient.listObjects)时默认列出最新对象列表,可以指定列出桶内所有版本对象列表(ObsClient.listVersions)。
  5. 除了删除标记外,每个版本的对象存储均需计费。

Enabled

暂停状态

  1. 旧的版本数据继续保留。
  2. 上传对象时创建对象的版本号为null,上传同名的对象将覆盖原有同名的版本号为null的对象。
  3. 可以指定版本号下载对象,不指定版本号默认下载最新对象。
  4. 删除对象时可以指定版本号删除,不带版本号删除对象将产生一个版本号为null的删除标记,并删除版本号为null的对象。
  5. 除了删除标记外,每个版本的对象存储均需计费。

Suspended

以下代码展示了如何设置桶的多版本状态:

// 创建ObsClient实例
var obsClient = new ObsClient({
    // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。
    // 前端本身没有process对象,可以使用webpack类打包工具定义环境变量,就可以在代码中运行了。
    // 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.html
    access_key_id: process.env.AccessKeyID,
    secret_access_key: process.env.SecretAccessKey,
    // 这里以中国-香港为例,其他地区请按实际情况填写
    server: 'https://obs.ap-southeast-1.myhuaweicloud.com'
});

// 启用桶多版本状态
obsClient.setBucketVersioning({
       Bucket : 'bucketname',
       VersionStatus : 'Enabled'
}, function (err, result) {
       if(err){
              console.log('Error-->' + err);
       }else{
              console.log('Status-->' + result.CommonMsg.Status);
       }
});

// 暂停桶多版本状态
obsClient.setBucketVersioning({
       Bucket : 'bucketname',
       VersionStatus : 'Suspended'
}, function (err, result) {
       if(err){
              console.log('Error-->' + err);
       }else{
              console.log('Status-->' + result.CommonMsg.Status);
       }
});

使用VersionStatus参数指定桶的多版本状态。