文档

版本控制

更新时间:

版本控制是针对云盒Bucket的数据保护功能。开启版本控制后,针对数据的覆盖和删除操作将会以历史版本的形式保存下来。您在错误覆盖或者删除对象(Object)后,能够将Bucket中存储的Object恢复至任意时刻的历史版本。

前提条件

  • 华东1(杭州)、华南1(深圳)、华南2(河源)、华北2(北京)、西南1(成都)地域支持使用OSS ON云盒服务。

  • 已购买云盒。具体操作,请参见购买云盒

使用场景

建议您在以下场景中使用版本控制,为您的数据安全提供更好的保障。

  • 数据误删除

    当前OSS不提供回收站功能。您删除OSS数据后想要找回时,可使用版本控制功能,恢复已删除的数据。

  • 文件被覆盖

    对于网盘、在线协作类产品,文件会被频繁修改,针对文件的编辑会产生大量的临时版本。您可以使用版本控制功能找回某个时间点的版本。

注意事项

  • 权限说明

    只有云盒Bucket的拥有者及授予了oss-cloudbox:PutBucketVersioning权限的RAM用户才能配置版本控制。

  • 功能互斥

    如果Bucket已开启版本控制,上传文件时附加的覆盖同名文件请求头x-oss-forbid-overwrite将不生效。更多信息,请参见请求头

版本控制状态

Bucket包含三种版本控制状态,分别为未开启、开启或者暂停。

  • 默认情况下,Bucket版本控制状态为“未开启”。一旦Bucket处于“开启”版本状态,将无法返回至“未开启”状态。但是,您可以暂停Bucket的版本控制状态。

  • 当Bucket版本控制处于“开启”状态时,OSS将为新上传的Object生成全局唯一的随机字符串版本ID。

  • 当Bucket版本控制处于“暂停”状态时,OSS将为新上传的Object生成特殊字符串为“null”的版本ID。

说明

当云盒Bucket版本控制处于“开启”状态时,由于Object的每个版本都被保存下来,每个版本都会占用存储空间。建议结合您的使用场景通过生命周期规则删除不再需要的历史版本。

数据保护

以下表格详细阐述了不同版本控制状态下,OSS对覆盖和删除Object的处理逻辑,帮助您了解版本控制状态下的数据保护机制。

版本控制状态

覆盖Object

删除Object

未开启

已有Object被直接覆盖,且无法恢复,只能获取最新版本Object。

直接删除,无法再获取此Object。

开启

为此Object添加新的版本ID,历史版本不受影响。

为此Object添加删除标记(Delete Marker),删除标记将携带一个全局唯一的版本ID,历史版本不受影响。

暂停

为此Object产生版本ID为“null”的新版本。

如果历史版本中已存在版本号为“null”的Object或删除标记,则将会被新的“null”版本Object覆盖,其他非“null”版本的Object或删除标记不受影响。

为此Object产生版本ID为“null”的删除标记。

如果历史版本中已存在版本号为“null”的Object或删除标记,则将会被新的删除标记覆盖,其他非“null”版本的Object或删除标记不受影响。

以下以图示的方法说明在Bucket版本控制状态处于“开启”和“暂停”时,上传同名Object或删除Object时OSS的处理行为。图示中的版本号均以简短版本号代替。

  • 开启版本控制下的Object覆盖操作

    在开启版本控制的Bucket中连续执行上传Object操作,Object虽然被多次覆盖,但每次覆盖操作均会产生一个独立的版本ID。

    1

  • 开启版本控制下的Object删除操作

    在开启版本控制下的Bucket中删除Object时,历史版本Object不会被真正删除,而是产生一个删除标记来标识Object的当前版本是删除状态。如果再重复上传同名Object,将产生新的版本ID。

    2

  • 暂停版本控制下的Object覆盖操作

    在暂停版本控制状态Bucket中上传Object时,历史版本数据继续保留,新上传的Object版本号为“null”。如果再重复上传同名Object,将产生新的“null”版本,并自动把前一次的“null”版本覆盖。

    3

  • 暂停版本控制下的Object删除操作

    在暂停版本控制下的Bucket中删除Object时,历史版本Object不会被真正删除,而是产生一个删除标记来标识Object的当前版本是删除状态。

    4

从上述信息得知,当您的Bucket处于版本控制状态时,针对数据的覆盖和删除操作将会以历史版本的形式保存下来。您在错误覆盖或者删除Object后,能够将Bucket中存储的Object恢复至任意时刻的历史版本。

开启版本控制

开启版本控制后,OSS会为Bucket中所有Object的每个版本指定唯一的versionId。

使用OSS控制台

  • 新建云盒Bucket时开启版本控制

    1. 登录OSS管理控制台

    2. 在左侧导航栏,选择数据服务 > 云盒Bucket,然后单击左上角的创建Bucket

    3. 创建Bucket页面配置各项参数。

      其中,版本控制区域选择开通。其他参数的配置详情,请参见创建云盒Bucket

    4. 单击确定
  • 对已创建的云盒Bucket开启版本控制

    1. 在左侧导航栏,选择数据服务 > 云盒Bucket,然后在Bucket列表中单击目标Bucket。

    2. 在左侧导航栏,选择数据安全 > 版本控制

    3. 单击版本控制右侧的开启

使用Java SDK

仅支持通过Java SDK开启版本控制,Java SDK要求3.15.0及以上版本。

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.*;
import com.aliyun.oss.common.auth.DefaultCredentialProvider;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.ClientBuilderConfiguration;
import com.aliyun.oss.common.auth.CredentialsProviderFactory;
import com.aliyun.oss.common.auth.EnvironmentVariableCredentialsProvider;

public class Demo {
    public static void main(String[] args) throws Exception {
        // 填写云盒Bucket的数据域名。
        String endpoint = "https://cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com";
        // 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填写云盒Bucket名称,例如examplebucket。
        String bucketName = "examplebucket";
        // 填写云盒Bucket所在地域。
        String region = "cn-hangzhou";
        // 填写云盒ID。
        String cloudBoxId = "cb-f8z7yvzgwfkl9q0h****";

        // 创建OSSClient实例。
        ClientBuilderConfiguration conf = new ClientBuilderConfiguration();
        conf.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(new DefaultCredentialProvider(credentialsProvider.getCredentials()))
                .clientConfiguration(conf)
                .region(region)
                .cloudBoxId(cloudBoxId)
                .build();

        try {
            // 设置Bucket为开启版本控制状态。
            BucketVersioningConfiguration configuration = new BucketVersioningConfiguration();
            configuration.setStatus(BucketVersioningConfiguration.ENABLED);
            SetBucketVersioningRequest request = new SetBucketVersioningRequest(bucketName, configuration);
            ossClient.setBucketVersioning(request);
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

使用命令行工具ossutil

关于使用ossutil开启版本控制的具体操作,请参见设置版本控制状态

使用REST API

如果您的程序自定义要求较高,您可以直接发起REST API请求。直接发起REST API请求需要手动编写代码计算签名。更多信息,请参见PutBucketVersioning

暂停版本控制

开启版本控制后,您还可以随时暂停版本控制以停止在Bucket中继续累积同一Object的新版本。暂停版本控制后,OSS将为新生成的Object添加versionId为null的版本,已有的历史版本Object将继续保留。

使用OSS控制台

  1. 在左侧导航栏,选择数据服务 > 云盒Bucket,然后在Bucket列表中单击目标Bucket。

  2. 在左侧导航栏,选择冗余与容错 > 版本控制

使用Java SDK

仅支持通过Java SDK暂停版本控制,Java SDK要求3.15.0及以上版本。

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.*;
import com.aliyun.oss.common.auth.DefaultCredentialProvider;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.ClientBuilderConfiguration;
import com.aliyun.oss.common.auth.CredentialsProviderFactory;
import com.aliyun.oss.common.auth.EnvironmentVariableCredentialsProvider;

public class Demo {
    public static void main(String[] args) throws Exception {
        // 填写云盒Bucket的数据域名。
        String endpoint = "https://cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com";
        // 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填写云盒Bucket名称,例如examplebucket。
        String bucketName = "examplebucket";
        // 填写云盒Bucket所在地域。
        String region = "cn-hangzhou";
        // 填写云盒ID。
        String cloudBoxId = "cb-f8z7yvzgwfkl9q0h****";

        // 创建OSSClient实例。
        ClientBuilderConfiguration conf = new ClientBuilderConfiguration();
        conf.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(new DefaultCredentialProvider(credentialsProvider.getCredentials()))
                .clientConfiguration(conf)
                .region(region)
                .cloudBoxId(cloudBoxId)
                .build();

        try {
            // 设置Bucket为暂停版本控制状态。
            BucketVersioningConfiguration configuration = new BucketVersioningConfiguration();
            configuration.setStatus(BucketVersioningConfiguration.SUSPENDED);
            SetBucketVersioningRequest request = new SetBucketVersioningRequest(bucketName, configuration);
            ossClient.setBucketVersioning(request);
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

使用命令行工具ossutil

关于使用ossutil暂停版本控制的具体操作,请参见设置版本控制状态

使用REST API

如果您的程序自定义要求较高,您可以直接发起REST API请求。直接发起REST API请求需要手动编写代码计算签名。更多信息,请参见PutBucketVersioning

  • 本页导读 (1)