更新时间:2023-11-09 GMT+08:00

设置桶多版本状态

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

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

多版本状态

说明

OBS .NET SDK对应值

启用状态

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

VersionStatusEnum.Enabled

暂停状态

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

VersionStatusEnum.Suspended

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

// 初始化配置参数
ObsConfig config = new ObsConfig();
config.Endpoint = "https://your-endpoint";
// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。
// 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.html
string accessKey= Environment.GetEnvironmentVariable("AccessKeyID", EnvironmentVariableTarget.Machine);
string secretKey= Environment.GetEnvironmentVariable("SecretAccessKey", EnvironmentVariableTarget.Machine);
// 创建ObsClient实例
ObsClient client = new ObsClient(accessKey, secretKey, config);
// 设置桶的多版本状态
try
{
    SetBucketVersioningRequest request = new SetBucketVersioningRequest();
    request.BucketName = "bucketname";
    request.Configuration = new VersioningConfiguration();
    //开启桶的多版本
    request.Configuration.Status = VersionStatusEnum.Enabled;
    SetBucketVersioningResponse response = client.SetBucketVersioning(request);
    Console.WriteLine("Set bucket version response: {0}", response.StatusCode);
}
catch (ObsException ex)
{
    Console.WriteLine("ErrorCode: {0}", ex.ErrorCode);
    Console.WriteLine("ErrorMessage: {0}", ex.ErrorMessage);
}