更新时间:2024-12-03 GMT+08:00

设置桶多版本状态

开发过程中,您有任何问题可以在github上提交issue

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

多版本状态

说明

OBS C SDK对应值

启用状态

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

OBS_VERSION_STATUS_ENABLED

暂停状态

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

OBS_VERSION_STATUS_SUSPENDED

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

参数描述

字段名

类型

约束

说明

option

请求桶的上下文,配置option

必选

桶参数。

version_status

char *

必选

表示桶的多版本状态:OBS_VERSION_STATUS_ENABLED,OBS_VERSION_STATUS_SUSPENDED。

handler

obs_response_handler *

必选

回调函数。

callback_data

void *

可选

回调数据。

static void test_set_bucket_version()
{
    obs_status ret_status = OBS_STATUS_BUTT;
    // 创建并初始化option
    obs_options option;
    init_obs_options(&option);
    option.bucket_options.host_name = "<your-endpoint>";
    option.bucket_options.bucket_name = "<Your bucketname>";

    // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量ACCESS_KEY_ID和SECRET_ACCESS_KEY。
    // 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.html
    option.bucket_options.access_key = getenv("ACCESS_KEY_ID");
    option.bucket_options.secret_access_key = getenv("SECRET_ACCESS_KEY");
    // 设置响应回调函数
    obs_response_handler response_handler =
    { 
        0, &response_complete_callback
    };
    // 开启桶的多版本控制
    set_bucket_version_configuration(&option, OBS_VERSION_STATUS_ENABLED, 
        &response_handler, &ret_status);
    if (OBS_STATUS_OK == ret_status) {
        printf("set bucket version successfully. \n");
    }
    else
    {
        printf("set bucket version failed(%s).\n", obs_get_status_name(ret_status));
    }
}